ALTER APPLICATION ROLE

修改现有应用程序角色的属性。

另请参阅:

CREATE APPLICATION ROLEGRANT APPLICATION ROLEREVOKE APPLICATION ROLESHOW APPLICATION ROLES

语法

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
Copy

参数

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;
Copy
ALTER APPLICATION ROLE app_role SET
  COMMENT = 'Application role for the Hello Snowflake application.';
Copy
ALTER APPLICATION ROLE app_role UNSET COMMENT;
Copy
语言: 中文