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> ]
Copy

パラメーター

name

Snowflake内のdbtプロジェクトオブジェクトの識別子（名前）を指定する文字列。dbtプロジェクトが作成されるスキーマで一意である必要があります。

また、識別子はアルファベット文字で始まる必要があり、識別子文字列全体が二重引用符で囲まれていない限り、スペースや特殊文字を含めることはできません（例: "My object"）。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

詳細については、 識別子の要件 をご参照ください。

LIMIT rows

オプションで、返される行の最大数を制限します。実際に返される行数は、指定された制限より少ない場合があります。例えば、既存のオブジェクトの数が指定された制限より少ないなどです。

デフォルト: 値なし（出力に制限は非適用）。

アクセス制御の要件

この操作の実行に使用される ロール には、少なくとも次の 権限 が必要です。

権限

オブジェクト

USAGE

dbtプロジェクトオブジェクト

MONITOR

dbtプロジェクトオブジェクト

OWNERSHIP

dbtプロジェクトオブジェクト

使用上の注意

  • このコマンドの実行には、稼働中のウェアハウスは必要ありません。

  • このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。

  • MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者（ ACCOUNTADMIN ロールを持つユーザー）とセキュリティ管理者（ SECURITYADMIN ロールを持つユーザー）のみが MANAGE GRANTS 権限を持っています。

  • このコマンドの出力を後処理するには、 パイプ演算子 （->>）または RESULT_SCAN 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。

    たとえば、パイプ演算子または RESULT_SCAN 関数を使用して、 SHOW コマンド出力から特定の列を選択したり、行をフィルター処理したりできます。

    出力列を参照する場合は、列名に:ref:二重引用符<label-delimited_identifier>`で囲まれた識別子を使用します。たとえば、出力列 ``type` を選択するには、 SELECT "type" を指定します。

    SHOW コマンドの出力列名は小文字のため、二重引用符で囲まれた識別子を使用する必要があります。二重引用符により、 SELECT リストまたは WHERE 句内の列名が、スキャンされた SHOW コマンド出力内の列名と一致することが保証されます。

出力

コマンド出力では、次の列にdbtプロジェクトのバージョンに関するテーブルプロパティとメタデータが提供されます。

列

説明

created_on

dbtプロジェクトオブジェクトが作成された日時。

name

dbtプロジェクトバージョンの自動割り当て名。例: VERSION$1。

alias

割り当てたdbtプロジェクトのエイリアス（例: ALTERDBTPROJECT<name>ADDVERSION<alias>FROM...）指定されていない場合はNULL。

location_uri

dbtプロジェクトバージョンの完全な URL。

is_default

dbtプロジェクトオブジェクトのデフォルトバージョンがこのバージョンをポイントしている場合は TRUE。

is_live

dbtプロジェクトのバージョンがリストのライブバージョンの場合は TRUE。

is_first

dbtプロジェクトが最初のバージョンの場合は TRUE。

is_last

dbtプロジェクトが最後のバージョンの場合は TRUE。

comment

dbtプロジェクトに設定されたコメント。

source_location_uri

このdbtプロジェクトバージョンが作成されるソースロケーション URI。

git_commit_hash

dbtプロジェクトバージョンがgitソースから作成された場合は、gitコミットハッシュ。

例

my_dbt_project のすべてのバージョンを表示:

SHOW VERSIONS IN DBT PROJECT my_dbt_project;
Copy
+---------------------------------+-----------+-------+----------------------------------------------------------------------+------------+---------+----------+---------+---------+---------------------+-----------------+
|             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            |
+---------------------------------+-----------+------------------------------+-----------------------------------------------+------------+--------------------+---------+---------+---------------------+-----------------+
言語: 日本語