CREATE ORGANIZATION PROFILE

创建组织配置文件，该配置文件是用于发布组织列表或查询组织列表信息而不装载列表的统一列表定位符 (ULL) 的一部分。要创建组织配置文件，您需要修改列表清单，然后将其移动到暂存区，随后即可在其中发布或取消发布。

另请参阅：

ALTER ORGANIZATION PROFILE、DESCRIBE AVAILABLE ORGANIZATION PROFILE、DESCRIBE ORGANIZATION PROFILE、DROP ORGANIZATION PROFILE、SHOW AVAILABLE ORGANIZATION PROFILES、SHOW ORGANIZATION PROFILES、SHOW VERSIONS IN ORGANIZATION PROFILE、组织配置文件清单引用。

语法

CREATE ORGANIZATION PROFILE [ IF NOT EXISTS ] <name>

CREATE ORGANIZATION PROFILE [ IF NOT EXISTS ] <name>
  FROM @<yaml_manifest_stage_location>
  [ VERSION <version_alias_name> ]
  [ PUBLISH = { TRUE | FALSE } ]
Copy

必填参数

name

指定组织配置文件的标识符（名称）的字符串。它在当前组织中必须唯一。标识符必须符合 Snowflake 标识符要求。请参阅 标识符要求。此外，组织配置文件名称只能包含大写字符或数字，必须以大写字符开头，且名称长度不能超过 128 个字符。

FROM @yaml_manifest_stage_location

指定外部暂存区、内部暂存区或 Git 存储库克隆 YAML 格式清单暂存区的位置。

可选参数

VERSION version_alias_name

可选。指定所添加版本的唯一版本标识符。如果未指定 VERSION version_name，则不会创建别名。如果标识符包含空格、特殊字符或大小写混合字符，则整个标识符必须放在双引号内。放在双引号内的标识符也区分大小写。FIRST、LAST、DEFAULT 或 LIVE 关键字保留为版本快捷关键字，不能使用。唯一版本标识符不能以“version$”开头，并且不能包含斜杠 (/)。有关标识符语法的信息，请参阅 标识符要求。

PUBLISH = { TRUE | FALSE }

可选。指定组织配置文件应采用何种发布方式。

如果为 TRUE，则组织配置文件会立即发布。

默认：FALSE。

访问控制要求

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

权限

对象

备注

CREATE ORGANIZATION PROFILE

账户

组织配置文件只能通过组织中的组织账户创建。GLOBALORGADMIN 角色已获授 CREATE ORGANIZATION PROFILE 权限。

使用说明

  • 使用 CREATE ORGANIZATION PROFILE 创建的组织配置文件在发布之前为 DRAFT。

示例

此示例创建了一个名为 OrgProfileDB 的数据库、一个名为 my_test_state_org_profile 的暂存区和一个标题为 MY_ORG_PROFILE 的组织配置文件。title 字段代表提供商域，它显示在组织列表下方，在内部市场中作为筛选选项显示在 Providers 下方。

CREATE DATABASE OrgProfileDB;
CREATE STAGE my_test_stage_org_profile;
COPY INTO @my_test_stage_org_profile/manifest.yml
  FROM (
    SELECT $$
      title: "MY_ORG_PROFILE"
      description: "Profile for SE Business Unit"
      contact: "contact_name@myemail.com"
      approver_contact: "approver_name@email.com"
      allowed_publishers:
        access:
          - all_internal_accounts: "true"
      logo: "urn:icon:shieldlock:blue"
    $$
  )
  SINGLE = TRUE
  OVERWRITE = TRUE
  FILE_FORMAT = (
    COMPRESSION = NONE
    ESCAPE_UNENCLOSED_FIELD = NONE
  );
Copy

此示例发布来自 my_test_stage_org_profile 暂存区的名为 MYPROFILENAME 的组织配置文件。

CREATE ORGANIZATION PROFILE MYPROFILENAME
 FROM @my_test_stage_org_profile
 PUBLISH=TRUE;
Copy
语言: 中文