文档首页
MySQL 9.0 参考手册
相关文档 下载本手册

MySQL 9.0 参考手册  /  ...  /  SET ROLE 语句

15.7.1.11 SET ROLE 语句

SET ROLE {
    DEFAULT
  | NONE
  | ALL
  | ALL EXCEPT role [, role ] ...
  | role [, role ] ...
}

SET ROLE 通过指定当前用户授予的角色中哪些角色处于活动状态来修改当前用户在当前会话中的有效权限。授予的角色包括显式授予用户的角色和 mandatory_roles 系统变量值中命名的角色。

示例

SET ROLE DEFAULT;
SET ROLE 'role1', 'role2';
SET ROLE ALL;
SET ROLE ALL EXCEPT 'role1', 'role2';

每个角色名称使用 第 8.2.5 节,“指定角色名称” 中描述的格式。角色名称的主机名部分(如果省略)默认为 '%'

用户直接被授予的权限(而不是通过角色)不受活动角色更改的影响。

该语句允许这些角色说明符

  • DEFAULT:激活帐户默认角色。默认角色是使用 SET DEFAULT ROLE 指定的角色。

    当用户连接到服务器并成功进行身份验证时,服务器会确定要作为默认角色激活哪些角色。如果 activate_all_roles_on_login 系统变量已启用,服务器将激活所有授予的角色。否则,服务器将隐式执行 SET ROLE DEFAULT。服务器仅激活可以激活的默认角色。服务器会将其错误日志中写入无法激活的默认角色的警告,但客户端不会收到任何警告。

    如果用户在会话期间执行 SET ROLE DEFAULT,如果任何默认角色无法激活(例如,如果它不存在或未授予用户),则会发生错误。在这种情况下,当前活动角色不会更改。

  • NONE:将活动角色设置为 NONE(没有活动角色)。

  • ALL:激活授予帐户的所有角色。

  • ALL EXCEPT role [, role ] ...:激活授予帐户的所有角色,除了命名的角色。命名的角色不需要存在或授予帐户。

  • role [, role ] ...:激活命名的角色,这些角色必须授予帐户。

注意

SET DEFAULT ROLESET ROLE DEFAULT 是不同的语句

  • SET DEFAULT ROLE 定义在帐户会话中默认激活哪些帐户角色。

  • SET ROLE DEFAULT 将当前会话中的活动角色设置为当前帐户的默认角色。

有关角色使用示例,请参阅 第 8.2.10 节,“使用角色”