SHOW VERSIONS IN LISTING

すべてのリストのバージョンの詳細をリストして提供します。

こちらもご参照ください。

CREATE LISTING、 ALTER LISTING、 DESCRIBE LISTING、 DROP LISTING

構文

SHOW VERSIONS IN LISTING <name>
  [ LIMIT <rows> ]
Copy

パラメーター

name

リスト識別子（名前）を指定します。識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

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

LIMIT rows

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

出力

コマンドの出力には、オブジェクトのプロパティとメタデータを説明する以下の列が含まれます。

列

説明

created_on

バージョンが作成された日時。

name

システムが生成したバージョン名。

alias

ユーザーが指定したバージョンのエイリアス。

location_url

バージョンの完全 URL。このバージョンに対してステージ操作を実行することができます。

is_default

公開されるリストのバージョンを識別します。

is_live

バージョンがリストのライブバージョンであるかどうかを識別します。

is_first

バージョンが最初のリストバージョンかどうかを識別します。

is_last

バージョンが最終リストバージョンかどうかを識別します。

comment

リストバージョンに対するオプションのコメント。

source_location_url

このバージョンの作成元となったソースロケーションの URL。

git_commit_hash

バージョンがgitソースから作成されたものである場合は、gitのコミットハッシュ。

アクセス制御の要件

  • リストのバージョンを表示するには、リストに対して USAGE または OWNERSHIP の権限を持つロールを使用している必要があります。

使用上の注意

  • LIMIT rows の値は 10000 を超えることはできません。LIMIT rows を省略した場合、結果セットが1万行を超えるとコマンドはエラーになります。

    1万件を超える記録が存在する結果を表示するには、 LIMIT rows を含めるか、 Snowflake Information Schema の対応するビューをクエリします。

  • このコマンドの出力を後処理するには、 パイプ演算子 （->>）または 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.

例

MYLISTING リストのすべてのバージョンを表示します。

SHOW VERSIONS IN LISTING MYLISTING
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: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              |                                       |
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+
言語: 日本語