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 万条记录的结果，请在 Snowflake Information Schema 中包含 LIMIT rows 或查询相应的视图。

  • 若要对此命令的输出进行后处理，可以使用 RESULT_SCAN 函数，该函数会将输出视为可查询的表。您还可以使用 管道运算符 来查询此命令的输出。

示例

显示 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              |                                       |
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+
语言: 中文