CREATE ORGANIZATION LISTING¶

语法¶

CREATE ORGANIZATION LISTING [ IF NOT EXISTS ] <name>
  [ { SHARE <share_name>  |  APPLICATION PACKAGE <package_name> } ]
  AS '<yaml_manifest_string>'
  [ PUBLISH = { TRUE | FALSE } ]
  [ REVIEW = { TRUE | FALSE } ]

参数¶

name

指定列表的标识符（名称）。它必须符合以下条件：

• 无论账户位于哪个 Snowflake 区域，在账户中都必须是唯一的。统一列表定位器 (ULL) 在同一组织内必须是唯一的。

• 不能包含嵌入的美元符号。

• 必须符合 Snowflake 标识符要求。请参阅 标识符要求。

SHARE share_name

指定要附加到列表的共享的标识符。

APPLICATION PACKAGE package_name

指定附加到列表的应用程序包。

另请参阅 SHOW APPLICATION PACKAGES。

AS 'yaml_manifest_string'

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

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

PUBLISH = { TRUE | FALSE }

指定如何发布列表。

如果为 TRUE，列表会立即发布到内部市场。

默认：TRUE。

REVIEW =  { TRUE | FALSE }

指定列表是否提交以供审查和批准。

默认：TRUE。

下表列出了不同的 PUBLISH 和 REVIEW 属性组合及其相关行为：

PUBLISH	REVIEW	行为
TRUE	TRUE	请求审核，在获得批准后立即发布。
TRUE	FALSE	返回错误。在发布之前，必须审查列表。
FALSE	TRUE	请求无需自动发布的审查。
FALSE	FALSE	将列表保存为草稿，无需审查或发布。

访问控制要求¶

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

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

使用说明¶

• 使用 CREATE ORGANIZATION LISTING ... 创建的列表会自动发布。

示例¶

本示例使用清单 YAML 中的指定设置创建一个名为 MYORGLISTING 的列表。它针对同一区域同一账户中的同一角色，包括支持和审批联系人。

USE ROLE <organization_listing_role>;

CREATE ORGANIZATION LISTING MYORGLISTING
SHARE <share_name> AS
$$
title: "My title"
description: "One region, all accounts"
organization_profile: "INTERNAL"
organization_targets:
discovery:
   - account: "<account_name>"
roles:
   - "<role>"
access:
   - account: "<account_name>"
   roles:
   - "<role>"
support_contact: "support@somedomain.com"
approver_contact: "approver@somedomain.com"
locations:
   access_regions:
   - name: "PUBLIC.<snowflake_region>"
$$
;