SHOW VERSIONS IN DBT PROJECT¶
dbtプロジェクトオブジェクト のすべてのバージョンのリストを表示します。
- こちらもご参照ください。
ALTER DBT PROJECT、 DESCRIBE DBT PROJECT、 EXECUTE DBT PROJECT、 SHOW DBT PROJECTS、 DROP DBT PROJECT
構文¶
SHOW VERSIONS IN DBT PROJECT <name>
[ LIMIT <number> ]
パラメーター¶
nameSnowflake内のdbtプロジェクトオブジェクトの識別子(名前)を指定する文字列。dbtプロジェクトが作成されるスキーマで一意である必要があります。
また、識別子はアルファベット文字で始まる必要があり、識別子文字列全体が二重引用符で囲まれていない限り、スペースや特殊文字を含めることはできません(例:
"My object")。二重引用符で囲まれた識別子も大文字と小文字が区別されます。詳細については、 識別子の要件 をご参照ください。
LIMIT rowsオプションで、返される行の最大数を制限します。実際に返される行数は、指定された制限より少ない場合があります。例えば、既存のオブジェクトの数が指定された制限より少ないなどです。
デフォルト: 値なし(出力に制限は非適用)。
アクセス制御の要件¶
この操作の実行に使用される ロール には、少なくとも次の 権限 が必要です。
権限 |
オブジェクト |
|---|---|
USAGE |
dbtプロジェクトオブジェクト |
MONITOR |
dbtプロジェクトオブジェクト |
OWNERSHIP |
dbtプロジェクトオブジェクト |
使用上の注意¶
このコマンドの実行には、稼働中のウェアハウスは必要ありません。
このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。
MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者( ACCOUNTADMIN ロールを持つユーザー)とセキュリティ管理者( SECURITYADMIN ロールを持つユーザー)のみが MANAGE GRANTS 権限を持っています。
このコマンドの出力を後処理するには、 パイプ演算子 (
->>)または RESULT_SCAN 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。このコマンドの出力列名は小文字で生成されます。パイプ演算子または でこのコマンドの結果セットを消費する場合 RESULT_SCAN 関数の場合は、を使用します 二重引用符で囲まれた識別子 クエリの列名に を使用し、スキャンされた出力の列名と一致するようにします。たとえば、出力列の名前が次の場合
type``次に を指定します ``"type"識別子用。
出力¶
コマンド出力では、次の列にdbtプロジェクトのバージョンに関するテーブルプロパティとメタデータが提供されます。
列 |
説明 |
|---|---|
|
dbtプロジェクトオブジェクトが作成された日時。 |
|
dbtプロジェクトバージョンの自動割り当て名。例: |
|
割り当てたdbtプロジェクトのエイリアス(例: |
|
dbtプロジェクトバージョンの完全な URL。 |
|
dbtプロジェクトオブジェクトのデフォルトバージョンがこのバージョンをポイントしている場合は TRUE。 |
|
dbtプロジェクトのバージョンがリストのライブバージョンの場合は TRUE。 |
|
dbtプロジェクトが最初のバージョンの場合は TRUE。 |
|
dbtプロジェクトが最後のバージョンの場合は TRUE。 |
|
dbtプロジェクトに設定されたコメント。 |
|
このdbtプロジェクトバージョンが作成されるソースロケーション URI。 |
|
dbtプロジェクトバージョンがgitソースから作成された場合は、gitコミットハッシュ。 |
例¶
my_dbt_project のすべてのバージョンを表示:
SHOW VERSIONS IN DBT PROJECT my_dbt_project;
+---------------------------------+-----------+-------+----------------------------------------------------------------------+------------+---------+----------+---------+---------+---------------------+-----------------+
| created_on | name | alias | location_uri | is_default | is_live | is_first | is_last | comment | source_location_uri | git_commit_hash |
+---------------------------------+-----------+-------+----------------------------------------------------------------------+------------+--------------------+---------+---------+---------------------+-----------------+
| 2025-01-08 11:18:24.550 -0800 | VERSION$2 | null | snow://dbtproject/mydb.my_schema.my_dbt_project/versions/version$2/ | TRUE | FALSE | FALSE | TRUE | null | null | null |
| 2025-01-08 11:17:32.894 -0800 | VERSION$1 | null | snow://dbtproject/mydb.my_schema.my_dbt_project/versions/version$2/ | FALSE | FALSE | TRUE | FALSE | null | null | null |
+---------------------------------+-----------+------------------------------+-----------------------------------------------+------------+--------------------+---------+---------+---------------------+-----------------+