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 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。

    For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

    When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

    You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

出力

コマンド出力では、次の列に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            |
+---------------------------------+-----------+------------------------------+-----------------------------------------------+------------+--------------------+---------+---------+---------------------+-----------------+
言語: 日本語