大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:SET ROLE

· 52CE 我爱测

在当前会话下,激活当前用户拥有权限的角色。激活后,用户可以使用该角色进行相关操作。

SET ROLE

功能

在当前会话下,激活当前用户拥有权限的角色。激活后,用户可以使用该角色进行相关操作。

您可以使用 select is_role_in_session("<role_name>") 来检查指定角色在当前会话下是否已经被激活。

该命令从 3.0 版本开始支持。

注意事项

  • 用户只能激活自己已有权限的角色。

  • 用户可以通过 SHOW GRANTS 查看拥有的角色,可以通过SELECT CURRENT_ROLE 查看当前激活的角色。

  • 激活的角色会影响所有权限检查,包括对 information_schema 系统视图的查询。例如,执行 SET ROLE role1 后,查询 SELECT * FROM information_schema.tables 将只返回通过 role1 可访问的表。这确保了基于角色的访问控制在所有系统目录和元数据查询中得到一致应用。

语法

-- 激活特定角色,使用这个角色进行操作。
SET ROLE <role_name>[,<role_name>,..];
-- 激活除指定角色之外,用户拥有的所有角色。
SET ROLE ALL EXCEPT <role_name>[,<role_name>,..]; 
-- 激活用户拥有的所有角色。
SET ROLE ALL;

参数说明

role_name: 用户拥有的角色名。

示例

  1. 查看当前用户拥有的角色。

    SHOW GRANTS;
    +--------------+---------+----------------------------------------------+
    | UserIdentity | Catalog | Grants                                       |
    +--------------+---------+----------------------------------------------+
    | 'test'@'%'   | NULL    | GRANT 'db_admin', 'user_admin' TO 'test'@'%' |
    +--------------+---------+----------------------------------------------+
    
  2. 激活 db_admin 角色。

    SET ROLE db_admin;
    
  3. 查看当前生效的角色。

    SELECT CURRENT_ROLE();
    +--------------------+
    | CURRENT_ROLE()     |
    +--------------------+
    | db_admin           |
    +--------------------+
    

相关文档

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。