ALTER ORGANIZATION PROFILE¶

语法¶

ALTER ORGANIZATION PROFILE [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER ORGANIZATION PROFILE [ IF EXISTS ] <name> PUBLISH

ALTER ORGANIZATION PROFILE <name> ADD VERSION [ [ IF NOT EXISTS ] <version_alias_name> ]
  FROM @<yaml_manifest_stage_location>

ALTER ORGANIZATION PROFILE <name> ADD LIVE VERSION [ [ IF NOT EXISTS ] <version_alias_name> ]
  FROM LAST

ALTER ORGANIZATION PROFILE <name> COMMIT

ALTER ORGANIZATION PROFILE <name> ABORT

参数¶

name

指定所更改的组织配置文件的标识符（名称）。组织配置文件名称只能包含大写字符或数字，并且必须以大写字符开头。

RENAME TO new_name

将组织配置文件的名称更改为 new_name。新标识符在当前组织中必须唯一。标识符必须符合 Snowflake 标识符要求。请参阅 标识符要求。此外，组织配置文件名称只能包含大写字符或数字，并且必须以大写字符开头。

备注

组织中不能已有同名的组织配置文件；否则，该语句将返回错误。

PUBLISH

使之前不可发现的组织配置文件可被发现。

ADD VERSION [ [ IF NOT EXISTS ] version_alias_name ]

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

ADD LIVE VERSION [ [ IF NOT EXISTS ] version_alias_name ]

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

在实时版本提交之前，对实时版本中文件所做的更改不会应用于组织配置文件。组织配置文件的属性在实时版本提交之前保持不变。

FROM 'yaml_manifest_stage_location'

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

COMMIT

提交组织配置文件中的更改。所提交的实时版本必须包含有效的组织配置文件清单文件。

ABORT

放弃组织配置文件中的更改。

访问控制要求¶

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

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

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

使用说明¶

• 组织配置文件只能在草稿状态下重命名。

• 在为组织配置文件设置 YAML 格式清单的实时版本时，必须使用 COMMIT 以应用更改，或使用 ABORT 以放弃更改。一个组织配置文件一次只能有一个实时版本。

示例¶

更改组织配置文件 MYORGPROFILE，以使用更新的清单文件：

ALTER ORGANIZATION PROFILE MYORGPROFILE ADD VERSION V2 FROM @STAGE_PATH_WITH_UPDATED_MANIFEST;

发布组织配置文件 MYORGPROFILE：

ALTER ORGANIZATION PROFILE MYORGPROFILE PUBLISH;