ALTER LISTING¶

修改列表的属性。

另请参阅：: CREATE LISTING、DESCRIBE LISTING、SHOW LISTINGS、DROP LISTING、列表清单引用

语法¶

ALTER LISTING [ IF EXISTS ] <name>
  [ { PUBLISH | UNPUBLISH } ]
  [ COMMENT = '<string>'' ]

ALTER LISTING [ IF EXISTS ] <name> [ { PUBLISH | UNPUBLISH } ]
  [ COMMENT = '<string>'' ]

ALTER LISTING [ IF EXISTS ] <name> AS '<yaml_manifest_string>'
  [ PUBLISH={ TRUE | FALSE } ]
  [ REVIEW= { TRUE | FALSE } ]
  [ COMMENT = '<string>' ]

ALTER LISTING [ IF EXISTS ] <name> RENAME TO <new_name>;

ALTER LISTING [ IF EXISTS ] <name> SET COMMENT = '<string>'

Copy

参数¶

name

指定要更改的列表的标识符（即名称）。

yaml_manifest_string

指定列表的 YAML 格式清单。有关列表清单文件的详细信息和示例，请参阅列表清单引用。

清单通常以带美元引号的字符串形式提供。有关更多信息，请参阅以美元为引号的字符串常量。

RENAME TO new_name

指定列表的新标识符，该标识符必须是唯一的。如果新标识符已用于其他列表，则不能使用该标识符。

{ PUBLISH | UNPUBLISH }

指定要对列表执行的操作：

PUBLISH 使以前不可发现的列表变得可发现。

在以前发布的列表上指定 PUBLISH 不会起作用。
UNPUBLISH 使以前可发现的列表对新使用者而言不可发现。现有使用者可以继续访问与未发布的列表关联的数据。

在以前未发布的列表上指定 UNPUBLISH 不会起作用。

另请参阅取消发布列表。

SET ...

指定要为列表设置的一个（或多个）属性（用空格、逗号或换行符分隔）。

COMMENT = 'string_literal'
为现有列表添加注释或覆盖现有注释。

PUBLISH = { TRUE | FALSE }

指定应如何发布列表。

如果为 TRUE，列表会立即发布到 Marketplace Ops 以供审核。

默认：TRUE。

REVIEW = { TRUE | FALSE }

指定列表是否应提交到 Marketplace Ops 进行审核。

默认：TRUE。

PUBLISH 和 REVIEW 属性的不同值组合会导致以下行为：

PUBLISH	REVIEW	行为
TRUE	TRUE	请求审核，在获得批准后立即发布。
TRUE	FALSE	导致错误。您不能未经审核便在 Snowflake Marketplace 上发布列表。
FALSE	TRUE	请求审核，但审核后不会自动发布。
FALSE	FALSE	不请求审核或发布，将列表另存为草稿。

使用说明¶

只能重命名草稿列表或未发布的列表。

访问控制要求¶

用于执行此 SQL 命令的角色必须至少具有以下一项权限：

权限¶
权限	对象	备注
OWNERSHIP 或 MODIFY	要修改的列表。
用于配置 Cross-Cloud Auto-Fulfillment 的委派权限。	如果 ALTER 命令正为自动履行而修改清单内容	请参阅允许账户设置 Cross-Cloud Auto-Fulfillment。

请注意，对架构中的对象进行操作还需要对父数据库和架构具有 USAGE 权限。

有关创建具有指定权限集的自定义角色的说明，请参阅创建自定义角色。

有关对安全对象执行 SQL 操作的相应角色和权限授予的一般信息，请参阅访问控制概述。

示例¶

更改列表 MY_LISTING 以使用更新的清单文件：

ALTER LISTING MYLISTING
AS
  $$
  title: "MyListing"
  subtitle: "Subtitle for MyListing"
  description: "Description or MyListing"
  listing_terms:
    type: "STANDARD"
  targets:
    accounts: ["Org1.Account1"]
  usage_examples:
     - title: "this is a test sql"
       description: "Simple example"
       query: "select *"
  $$

Copy

更改列表 MYLISTING，并发布列表：

ALTER LISTING MYLISTING PUBLISH;

Copy

更改列表 MYLISTING，并取消发布列表。

ALTER LISTING MYLISTING UNPUBLISH;

Copy

更改列表 MYLISTING，并设置新注释：

ALTER LISTING MYLISTING SET COMMENT = 'My listing is ready!';

Copy