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

Apache Doris 中文参考:GRANT TO

· 52CE 我爱测

指定接收权限的用户。必须为使用 CREATE USER 创建过的 user_identity。user_identity 中的 host 可以是域名,如果是域名的话,权限的生效时间可能会有 1 分钟左右的延迟。

描述

GRANT 命令用于:

  1. 将指定的权限授予某用户或角色。
  2. 将指定角色授予某用户。

相关命令

语法

将指定的权限授予某用户或角色

GRANT <privilege_list> 
ON { <priv_level> 
    | RESOURCE <resource_name> 
    | WORKLOAD GROUP <workload_group_name> 
    | COMPUTE GROUP <compute_group_name> 
    | STORAGE VAULT <storage_vault_name>
   } 
TO { <user_identity> | ROLE <role_name> }

将指定角色授予某用户

GRANT <role_list> TO <user_identity> 

必选参数

1. <privilege_list>

需要赋予的权限列表,以逗号分隔。当前支持如下权限:

  • NODE_PRIV:集群节点操作权限,包括节点上下线等操作。
  • ADMIN_PRIV:除 NODE_PRIV 以外的所有权限。
  • GRANT_PRIV:操作权限的权限,包括创建删除用户、角色,授权和撤权,设置密码等。
  • SELECT_PRIV:对指定的库或表的读取权限。
  • LOAD_PRIV:对指定的库或表的导入权限。
  • ALTER_PRIV:对指定的库或表的 schema 变更权限。
  • CREATE_PRIV:对指定的库或表的创建权限。
  • DROP_PRIV:对指定的库或表的删除权限。
  • USAGE_PRIV:对指定资源、Workload Group、Compute Group 的使用权限。
  • SHOW_VIEW_PRIV:查看 view 创建语句的权限。

旧版权限转换:

  • ALL 和 READ_WRITE 会被转换成:SELECT_PRIV, LOAD_PRIV, ALTER_PRIV, CREATE_PRIV, DROP_PRIV。
  • READ_ONLY 会被转换为 SELECT_PRIV。

2. <priv_level>

支持以下四种形式:

  • ..*:权限可以应用于所有 catalog 及其中的所有库表。
  • catalog_name..:权限可以应用于指定 catalog 中的所有库表。
  • catalog_name.db.*:权限可以应用于指定库下的所有表。
  • catalog_name.db.tbl:权限可以应用于指定库下的指定表。

3. <resource_name>

指定 resource 名,支持 % 和 * 匹配所有资源,不支持通配符,比如 res*。

4. <workload_group_name>

指定 workload group 名,支持 % 和 * 匹配所有 workload group,不支持通配符。

5. <compute_group_name>

指定 compute group 名称,支持 % 和 * 匹配所有 compute group,不支持通配符。

6. <storage_vault_name>

指定 storage vault 名称,支持 % 和 * 匹配所有 storage vault,不支持通配符。

7. <user_identity>

指定接收权限的用户。必须为使用 CREATE USER 创建过的 user_identity。user_identity 中的 host 可以是域名,如果是域名的话,权限的生效时间可能会有 1 分钟左右的延迟。

8. <role_name>

指定接收权限的角色。如果指定的角色不存在,则会自动创建。

9. <role_list>

需要赋予的角色列表,以逗号分隔,指定的角色必须存在。

自 4.1.5 版本起,权限对象名最多为三段:db、db.table 或 catalog.db.table(也可使用相应通配形式);多于三段会被拒绝,不再忽略多余前缀。

权限控制

执行此 SQL 命令的用户必须至少具有以下权限:

权限(Privilege) 对象(Object) 说明(Notes)
GRANT_PRIV 用户(User)或 角色(Role) 用户或者角色拥有 GRANT_PRIV 权限才能进行 GRANT 操作

自 4.1.5 版本起,非 ADMIN 用户执行列级授权或撤权时,除原有 GRANT 权限外,还必须持有相应的表级权限,或列表中每一列的相应权限;只有 GRANT 权限不足以授出或撤销自己没有的列权限。

示例

  • 授予所有 catalog 和库表的权限给用户:

    GRANT SELECT_PRIV ON *.*.* TO 'jack'@'%';
    
  • 授予指定库表的权限给用户:

    GRANT SELECT_PRIV,ALTER_PRIV,LOAD_PRIV ON ctl1.db1.tbl1  TO 'jack'@'192.8.%';
    
  • 授予指定库表的权限给角色:

    GRANT LOAD_PRIV ON ctl1.db1.* TO ROLE 'my_role';
    
  • 授予所有 resource 的使用权限给用户:

    GRANT USAGE_PRIV ON RESOURCE * TO 'jack'@'%';
    
  • 授予指定 resource 的使用权限给用户:

    GRANT USAGE_PRIV ON RESOURCE 'spark_resource' TO 'jack'@'%';
    
  • 授予指定 resource 的使用权限给角色:

    GRANT USAGE_PRIV ON RESOURCE 'spark_resource' TO ROLE 'my_role';
    
  • 将指定 role 授予某用户:

    GRANT 'role1','role2' TO 'jack'@'%';
    
  • 将指定 workload group 授予用户:

    GRANT USAGE_PRIV ON WORKLOAD GROUP 'g1' TO 'jack'@'%';
    
  • 匹配所有 workload group 授予用户:

    GRANT USAGE_PRIV ON WORKLOAD GROUP '%' TO 'jack'@'%';
    
  • 将指定 workload group 授予角色:

    GRANT USAGE_PRIV ON WORKLOAD GROUP 'g1' TO ROLE 'my_role';
    
  • 允许用户查看指定 view 的创建语句:

    GRANT SHOW_VIEW_PRIV ON db1.view1 TO 'jack'@'%';
    
  • 授予用户对指定 compute group 的使用权限:

    GRANT USAGE_PRIV ON COMPUTE GROUP 'group1' TO 'jack'@'%';
    
  • 授予角色对指定 compute group 的使用权限:

    GRANT USAGE_PRIV ON COMPUTE GROUP 'group1' TO ROLE 'my_role';
    
  • 授予用户对所有 compute group 的使用权限:

    GRANT USAGE_PRIV ON COMPUTE GROUP '*' TO 'jack'@'%';
    
  • 授予用户对指定 storage vault 的使用权限:

    GRANT USAGE_PRIV ON STORAGE VAULT 'vault1' TO 'jack'@'%';
    
  • 授予角色对指定 storage vault 的使用权限:

    GRANT USAGE_PRIV ON STORAGE VAULT 'vault1' TO ROLE 'my_role';
    
  • 授予用户对所有 storage vault 的使用权限:

    GRANT USAGE_PRIV ON STORAGE VAULT '*' TO 'jack'@'%';
    

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

资料来源与适用范围

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

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

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