■ はじめに

小ネタ。

dbt CLI の --emptyフラグ についてメモっておく

【１】--emptyフラグ

* --emptyフラグを付与することにより、
　クエリに条件「where false limit 0」が追加され、
　0行のテーブル・ビューを生成する

https://docs.getdbt.com/reference/commands/run#the---empty-flag

【２】使用上の注意

* From dbt v1.8 (古いdbtだと機能としてない)
* dry run ではなく、実際にクエリが実行される
 => そのため、materialized="table" のモデルの場合
　洗い替え（DROP ＋ CTAS（CREATE TABLE AS SELECT））なので、
　もともとデータがあったら、そのデータは消されて空テーブルが出来上がる

【３】使いどころ

* クエリを回さず、文法を確認したい場合
 => Snowflakeの場合、スキャン量が大きいクエリではコスト削減に繋がる
* 空テーブルで良いのでテーブル作成したい場合

【４】--emptyあれこれ

１）使用例

dbt run --empty

dbt build --empty

２）--emptyかどうかの判断

{% if flags.EMPTY %}
 -- --emptyフラグが実行された場合
{% endif %}

補足：flags について

* 以下の公式ドキュメント参照のこと

https://docs.getdbt.com/reference/dbt-jinja-functions/flags

参考文献

https://zenn.dev/analytics_eng/articles/715b5763b165da
https://zenn.dev/finatext/articles/dbt-high-performance-incremental-model
https://dev.classmethod.jp/articles/dbt-try-unit-tests/

ランキング参加中

プログラミング

プログラムの超個人的なメモ

Memo for Programming.

【dbt】dbt CLI ～ --emptyフラグ～

■ はじめに

目次

【１】--emptyフラグ

【２】使用上の注意

【３】使いどころ

【４】--emptyあれこれ

１）使用例

２）--emptyかどうかの判断

参考文献

関連記事