dbtプロジェクトオブジェクトとファイルのバージョン

Snowflakeは、dbtプロジェクトオブジェクトとそのソースファイルの不変バージョンを維持します。このバージョン管理により、開発ライフサイクル全体の変更を追跡および管理できます。

注釈

dbtプロジェクトオブジェクトのバージョンは、実行に使用されるdbt Coreバージョンとは異なります。詳細については、 |sf-dbt|でサポートされているdbt Coreバージョン をご参照ください。

Snowflakeは、次の例に示すように、dbtプロジェクトステージ内のdbtプロジェクトオブジェクトのバージョンを識別します。

snow://dbt/my_db.my_schema.my_dbt_project_object/versions/version_id

version_id は以下の識別子のいずれかになります。

識別子

説明

VERSION$num

VERSION$num`形式のバージョン識別子を指定します。この場合、:samp:`num`は正の整数です。例: :code:`VERSION$1。

dbtプロジェクトオブジェクトを作成し、dbtプロジェクトオブジェクトの新しいバージョンごとに1つずつインクリメントする場合、バージョン番号は 1 で始まります。

Snowflakeは、次のタスクを実行するとバージョン識別子をインクリメントします。

  • ワークスペースから Redeploy dbt project します（ALTER コマンドを ADD VERSION オプションを指定して実行します）。

  • ALTER DBT PROJECT コマンドを使用してプロジェクトを更新します。

  • Snow CLI snow dbt deploy コマンドを --force オプションを指定して実行します。

:code:`OR REPLACE`オプションを指定してCREATE DBT PROJECTコマンドを指定して実行すると、Snowflakeはバージョン識別子を:code:`1`にリセットし、すべてのバージョンエイリアスを削除します。

LAST

dbtプロジェクトオブジェクトの最新バージョンを示します。

FIRST

dbtプロジェクトオブジェクトの最も古いバージョンを示します。

version_name_alias

ADDVERSIONオプションのある:doc:/sql-reference/sql/alter-dbt-project`コマンドを使用して、dbtプロジェクトオブジェクトの特定のバージョンに対して作成したカスタムバージョン名のエイリアスを示します。バージョン名のエイリアスは常に、 :code:`VERSION$3 のように特定のバージョン識別子にマッピングされます。

dbtプロジェクトステージに格納されているプロジェクトファイルはバージョンごとに整理され、各バージョンには独自のサブディレクトリがあります。例えば、:code:`VERSION$3`のバージョン識別子を持つ:code:`my_dbt_project_object`という名前のdbtプロジェクトオブジェクトや:file:`dbt_project.yml`という名前のdbtプロジェクトファイルは、:code:`snow://dbt/my_db.my_schema.my_dbt_project_object/versions/VERSION$3/dbt_project.yml`として参照できます。