CREATE ORGANIZATION LISTING¶

创建组织列表，以在组织内安全地共享数据产品。

语法¶

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

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

参数¶

name

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

无论账户位于哪个 Snowflake 区域，在账户中都必须是唯一的。统一列表定位器 (ULL) 在同一组织内必须是唯一的。
不能包含嵌入的美元符号。
必须符合 Snowflake 标识符要求。请参阅标识符要求。

FROM 'yaml_manifest_stage_location'

指定内部暂存区或 Git 存储库克隆 manifest.yml 文件的路径。

SHARE share_name

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

APPLICATION PACKAGE package_name

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

另请参阅 SHOW APPLICATION PACKAGES。

AS 'yaml_manifest_string'

组织配置文件的 YAML 清单。有关清单字段的详细信息和示例，请参阅组织列表清单引用。

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

PUBLISH = { TRUE | FALSE }

指定如何发布列表。

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

默认：TRUE。

访问控制要求¶

用于执行此操作的角色必须至少具有以下权限：


权限	对象	备注
CREATE ORGANIZATION LISTING 或 CREATE LISTING	账户	创建和更改组织列表。

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


权限	对象	备注
CREATE ORGANIZATION LISTING	ACCOUNT	将指定的共享或指定的 Snowflake Native App Framework 附加到列表。指定 Snowflake Native App Framework 时，还需要 OWNERSHIP 或 ATTACH LISTING。
IMPORT ORGANIZATION LISTING	ACCOUNT	装载列表或执行使用统一列表定位符 (ULL) 引用组织列表的查询。

使用说明¶

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

示例¶

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

备注

support_contact 是必填项。如果提供了 discovery 目标，则 approver_contact 是必填项。

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>"
$$

从特定的暂存位置创建名为“MYLISTING”的列表草稿。在以下示例中，manifest.yml 文件位于名为 listingstage 的暂存区的 listingmanifests 文件夹中。

CREATE ORGANIZATION LISTING MYLISTING
SHARE MySHARE FROM @dbforstage.public.listingstage/listingmanifests;