■ はじめに

DBT での色々な更新について徐々にではあるがまとめていく

【１】materialized
　１）materialized='table'
　２）materialized='view'
　３）materialized='incremental'
　４）materialized='ephemeral'
　５）materialized='materialized_view' / materialized='dynamic_table'　
【２】incremental_strategy
　１）append
　２）merge
　３）insert_overwrite
　４）delete+insert
　５）独自ストラテジ
【３】is_incremental()
【４】使用上の注意
　１）PostgreSQLの場合

【１】materialized

* dbtのモデルをDB/WHに保存するための戦略パターンを指定

cf. materialized = 具体化/具現化する

https://docs.getdbt.com/docs/build/materializations

１）materialized='table'

* データモデルを「テーブル」として作成（洗い替え）

２）materialized='view'

* データモデルを「ビュー」として作成

３）materialized='incremental'

* データモデルを「テーブル」として作成（追記・更新）

４）materialized='ephemeral'

* 共通テーブル式（CTE）として扱う

cf. ephemeral (エフェメラル) = つかの間の、はかない、短命な

５）materialized='materialized_view' / materialized='dynamic_table'

* データモデルを「マテリアライズドビュー」として作成
 + materialized='materialized_view' ... Postgres/Redshift/Databricks/Bigquery
 + materialized='dynamic_table' ... snowflake

https://docs.getdbt.com/blog/announcing-materialized-views

【２】incremental_strategy

* 以下の公式ドキュメントの表によると、使用するDWHによって
　取りうる設定値が異なる

https://docs.getdbt.com/docs/build/incremental-strategy#supported-incremental-strategies-by-adapter
https://iomete.com/docs/guides/dbt/dbt-incremental-models-by-examples

* 以下、主な取りうる値。

１）append

* データ追加（insert）

２）merge

* データ更新（update or insert）
* デフォルト

３）insert_overwrite

* 上書き追記

４）delete+insert

* 削除後に insert

５）独自ストラテジ

* Customすることも可能
 => 詳細は、以下の関連記事を参照

dbt ～更新 / 独自ストラテジ～
https://dk521123.hatenablog.com/entry/2025/10/01/173127

【３】is_incremental()

* materialized='incremental' 時でのテーブルの存在チェックで使用する
* True / False で返す
* 以下の条件を当てはまる場合、True になる
 + テーブルが既に存在する場合
 + full-refresh モードで動いていない
 + materialized='incremental'

https://docs.getdbt.com/docs/build/incremental-models#understanding-the-is_incremental-macro

サンプル

{% if is_incremental() %}

  -- this filter will only be applied on an incremental run
  -- (uses >= to include records arriving later on the same day as the last run of this model)
  where date_day >= (select max(date_day) from {{ this }})

{% endif %}

【４】使用上の注意

１）PostgreSQLの場合

* PostgreSQL が古いバージョンだと動かない場合がある

 => DBTが裏でMERGE INTO を使っており、
　　PostgreSQLの場合、MERGE INTO は PostgreSQL v15からサポートされる

 => PostgreSQL v12 を使っていたので、結構ハマった、、、

 => なお、PostgreSQLのバージョン確認は、「SELECT VERSION();」