ALTER ORGANIZATION ACCOUNT¶
修改现有 组织账户 的属性。
语法¶
ALTER ORGANIZATION ACCOUNT SET { [ accountParams ] | [ objectParams ] | [ sessionParams ] }
ALTER ORGANIZATION ACCOUNT UNSET <param_name> [ , ... ]
ALTER ORGANIZATION ACCOUNT SET RESOURCE_MONITOR = <monitor_name>
ALTER ORGANIZATION ACCOUNT SET { PASSWORD | SESSION } POLICY <policy_name>
ALTER ORGANIZATION ACCOUNT UNSET { PASSWORD | SESSION } POLICY
ALTER ORGANIZATION ACCOUNT SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]
ALTER ORGANIZATION ACCOUNT UNSET TAG <tag_name> [ , <tag_name> ... ]
ALTER ORGANIZATION ACCOUNT <name> RENAME TO <new_name> [ SAVE_OLD_URL = { TRUE | FALSE } ]
ALTER ORGANIZATION ACCOUNT <name> DROP OLD URL
备注
组织账户的 accountParams、objectParams 和 sessionParams 与其他账户的参数相同。有关其语法,请参阅 ALTER ACCOUNT。
参数¶
name
指定要更改的组织账户的标识符。
如果标识符包含空格或特殊字符,则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。
有关更多信息,请参阅 标识符要求。
SET ...
指定要为组织账户设置的一个(或多个)账户、会话和对象参数(用空格、逗号或换行符分隔):
任何其他用户都无法更改的账户参数。
在账户级别设置的会话和对象参数仅用作默认值,可以由其他用户更改。
有关您可以为组织账户设置的参数的描述,请参阅 参数。
UNSET ...
为您的账户指定一个(或多个)要取消设置的账户、会话和对象参数,这会将它们重置为系统默认值。
您可以使用单个 ALTER 语句重置多个属性;但是,每个属性 必须 用逗号分隔。重置属性时,请仅指定名称;指定属性的值将返回错误。
SET RESOURCE_MONITOR resource_monitor_name
特殊参数,用于指定资源监视器的名称,而资源监视器则用于控制账户中创建的所有虚拟仓库。
组织账户不宜大量用于分析或其他工作负载。
{ PASSWORD | SESSION } POLICY policy_name
TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]
指定 标签 名称和标签字符串值。
标签值始终为字符串,标签值的最大字符数为 256。
有关在语句中指定标签的信息,请参阅 对象和列的标签配额。
RENAME TO new_name
将组织账户名称更改为指定名称。
有关标识符的更多详细信息,请参阅 标识符要求。
组织管理员不能在登录组织账户期间重命名该组织账户,而应当先登录其他组织账户,然后再执行 ALTER ORGANIZATION ACCOUNT 命令。
SAVE_OLD_URL = { TRUE | FALSE }
与
RENAME TO
配合使用的可选参数可保留在重命名之前用于访问 Snowflake 的 账户 URL。默认情况下,Snowflake 会保存原始 URL,这意味着您可以使用旧 URL 或包含新账户名称的 URL 访问该组织账户。如果设置为FALSE
,则必须使用新 URL 才能访问该组织账户。- 默认值:
TRUE
DROP OLD URL
移除已重命名的组织账户的原始 账户 URL。删除旧 URL 后,必须使用包含新账户名称的 URL 才能访问该组织账户。
访问控制要求¶
只有具有 GLOBALORGADMIN 角色的用户才能执行此命令。
示例¶
重命名组织账户,同时允许用户使用新的或旧的账户 URL 访问该账户。
ALTER ORGANIZATION ACCOUNT original_acctname RENAME TO new_acctname;