ALTER APPLICATION ROLE¶
修改现有应用程序角色的属性。
语法¶
ALTER APPLICATION ROLE [ IF EXISTS ] <name> RENAME TO <new_name>
ALTER APPLICATION ROLE [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'
ALTER APPLICATION ROLE [ IF EXISTS ] <name> UNSET COMMENT
参数¶
name
指定应用程序角色的标识符。如果标识符包含空格或特殊字符,则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。
RENAME TO new_name
指定应用程序角色的新标识符。标识符在应用程序中必须是唯一的。
有关更多详细信息,请参阅 标识符要求。
请注意,在指定应用程序角色的完全限定名称时,不能 指定其他应用程序。应用程序的名称
application_name
必须保持不变。在重命名操作期间,只有application_role_name
可以发生变更。SET ...
指定要为应用程序角色设置的属性:
COMMENT = 'string_literal'
添加应用程序角色的注释,或覆盖其现有注释。
UNSET ...
指定要为应用程序角色取消设置的属性,这会将这些属性重置为默认值。
COMMENT
使用说明¶
此命令只能在使用 Native Apps Framework 创建的应用程序的上下文中运行。
只有应用程序角色所有者(即对应用程序角色具有 OWNERSHIP 权限的角色)或更高级别的角色才能运行此命令。
仅允许在同一应用程序中重命名应用程序角色。
关于元数据:
注意
客户应确保在使用 Snowflake 服务时,不会将个人数据(用户对象除外)、敏感数据、出口管制数据或其他受监管数据作为元数据输入。有关更多信息,请参阅 Snowflake 中的元数据字段。
示例¶
ALTER APPLICATION ROLE app_role RENAME TO new_app_role;
ALTER APPLICATION ROLE app_role SET
COMMENT = 'Application role for the Hello Snowflake application.';
ALTER APPLICATION ROLE app_role UNSET COMMENT;