SHOW VERSIONS IN LISTING¶
すべてのリストのバージョンの詳細をリストして提供します。
- こちらもご参照ください。
CREATE LISTING、 ALTER LISTING、 DESCRIBE LISTING、 DROP LISTING
構文¶
SHOW VERSIONS IN LISTING <name>
[ LIMIT <rows> ]
パラメーター¶
nameリスト識別子（名前）を指定します。識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。
詳細については、 識別子の要件 をご参照ください。
LIMIT rowsオプションで、返される行の最大数を制限すると同時に、結果の「ページネーション」を有効にします。実際に返される行数は、指定された制限より少ない場合があります。例えば、既存のオブジェクトの数が指定された制限より少ないなどです。
出力¶
コマンドの出力には、オブジェクトのプロパティとメタデータを説明する以下の列が含まれます。
列 |
説明 |
|---|---|
|
バージョンが作成された日時。 |
|
システムが生成したバージョン名。 |
|
ユーザーが指定したバージョンのエイリアス。 |
|
バージョンの完全 URL。このバージョンに対してステージ操作を実行することができます。 |
|
公開されるリストのバージョンを識別します。 |
|
バージョンがリストのライブバージョンであるかどうかを識別します。 |
|
バージョンが最初のリストバージョンかどうかを識別します。 |
|
バージョンが最終リストバージョンかどうかを識別します。 |
|
リストバージョンに対するオプションのコメント。 |
|
このバージョンの作成元となったソースロケーションの URL。 |
|
バージョンがgitソースから作成されたものである場合は、gitのコミットハッシュ。 |
アクセス制御の要件¶
リストのバージョンを表示するには、リストに対して USAGE または OWNERSHIP の権限を持つロールを使用している必要があります。
使用上の注意¶
LIMIT rowsの値は10000を超えることはできません。LIMIT rowsを省略した場合、結果セットが1万行を超えるとコマンドはエラーになります。1万件を超える記録が存在する結果を表示するには、
LIMIT rowsを含めるか、 Snowflake Information Schema の対応するビューをクエリします。
このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。このコマンドの出力をクエリするには、 パイプ演算子 を使用することもできます。
例¶
MYLISTING リストのすべてのバージョンを表示します。
SHOW VERSIONS IN LISTING MYLISTING
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+
| 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:39.921 -0800 | | | snow://listing/MYLISTING/versions/live/ | FALSE | TRUE | FALSE | FALSE | | @listingstage | |
| 2025-01-08 11:18:24.550 -0800 | VERSION$2 | | snow://listing/MYLISTING/versions/version$2/ | TRUE | FALSE | FALSE | TRUE | | @listingstage | |
| 2025-01-08 11:17:32.894 -0800 | VERSION$1 | | snow://listing/MYLISTING/versions/version$1/ | FALSE | FALSE | TRUE | FALSE | | @listingstage | |
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+