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	不请求审核或发布，将列表另存为草稿。

使用说明¶

列表只能在 DRAFT 状态下重命名。
在为列表设置 YAML 格式清单的实时版本时，您必须使用 COMMIT 以应用更改，或使用 ABORT 以放弃更改。

访问控制要求¶

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

权限	对象	备注
OWNERSHIP 或 MODIFY	要修改的列表。

如果您使用 ALTER 命令来修改自动履行的清单内容，则必须使用具有必要的委托权限的角色来配置 Cross-Cloud Auto-Fulfillment。请参阅允许账户设置 Cross-Cloud Auto-Fulfillment。

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

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

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

示例¶

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

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