权限项
本文详细描述了 StarRocks 中可以用于赋权的权限项及其含义。您可以通过 GRANT 和 REVOKE 操作对用户和角色进行权限的赋予和收回。
本文介绍的权限项从 3.0 版本开始提供,升级后的权限框架、语法与旧的系统无法兼容,请以 3.0 版本的操作说明为准。升级后,除个别操作外,您在旧系统上的大部分操作权限仍然保留。具体差异请见文档最后的升级指南。
权限列表
系统级权限 (SYSTEM)
| 权限 |
用途 |
| NODE |
用于操作节点,比如添加,删除,下线节点。为确保集群安全,此权限不可直接授予给用户和角色。cluster_admin 角色拥有此权限。 |
| GRANT |
创建用户/角色,更改用户/角色,将权限授予给用户/角色。此权限不可直接授予给用户和角色。user_admin 角色拥有此权限。 |
| CREATE RESOURCE GROUP |
创建资源组。 |
| CREATE RESOURCE |
创建资源给 Spark Load 和外表使用。 |
| CREATE EXTERNAL CATALOG |
创建 External Catalog。 |
| PLUGIN |
安装、卸载一个插件。 |
| REPOSITORY |
创建、删除、查看仓库。 |
| BLACKLIST |
创建、删除、查看 SQL 黑名单和 BE 黑名单。 |
| FILE |
创建、删除、查看文件。 |
| OPERATE |
管理副本、配置项、变量、transaction等。 |
| CREATE GLOBAL FUNCTION |
创建一个全局 UDF。 |
| CREATE STORAGE VOLUME |
为远程存储系统创建存储卷 (Storage Volume)。 |
| SECURITY |
创建或管理安全集成以及 Group Provider。 |
AI FUNCTION / AI PROVIDER {/* #ai-function-privileges */}
| 对象 |
权限 |
用途 |
| AI FUNCTION |
USAGE |
使用指定的 AI 函数。 |
| AI PROVIDER |
USAGE |
使用指定的 AI Provider。 |
说明:调用 AI 函数需要同时具备函数和所选 Provider 的 USAGE 权限,包括默认 Provider。管理 Provider 需要 SYSTEM OPERATE 权限。
资源组权限 (RESOURCE GROUP)
| 权限 |
用途 |
| ALTER |
为指定资源组 (resource group) 增加、减少分类器 (classifier)。 |
| DROP |
删除指定资源组。 |
| ALL |
拥有对该资源组的上述所有权限。 |
资源权限 (RESOURCE)
| 权限 |
用途 |
| USAGE |
使用该资源 (resource)。 |
| ALTER |
更改该资源。 |
| DROP |
删除该资源。 |
| ALL |
拥有对该资源的上述所有权限。 |
用户权限 (USER)
| 权限 |
用途 |
| IMPERSONATE |
允许用户 a 以用户 b 的身份执行操作。 |
全局用户自定义函数权限 (GLOBAL FUNCTION)
| 权限 |
用途 |
| USAGE |
在查询中使用该函数。 |
| DROP |
删除该函数。 |
| ALL |
拥有对该函数的上述所有所有权限。 |
数据目录权限 (CATALOG)
| 对象 |
权限 |
用途 |
CATALOG (内部目录,默认名称为 default_catalog) |
USAGE |
使用 internal catalog。 |
|
CREATE DATABASE |
在 internal catalog 里创建数据库。 |
|
ALL |
拥有对 internal catalog 的上述所有权限。 |
| CATALOG (外部目录) |
USAGE |
使用 external catalog。 |
|
DROP |
删除 external catalog。 |
|
ALL |
拥有对该 external catalog 的上述所有权限。 |
说明:StarRocks 内部数据目录不能删除。
数据库权限 (DATABASE)
| 权限 |
用途 |
| ALTER |
设置指定数据库的属性,重命名,设定配额等。 |
| DROP |
删除数据库。 |
| CREATE TABLE |
在数据库内创建表。 |
| CREATE VIEW |
创建视图。 |
| CREATE FUNCTION |
创建函数。 |
| CREATE MATERIALIZED VIEW |
创建物化视图。 |
| ALL |
拥有对该数据库的上述所有权限。 |
表权限 (TABLE)
| 权限 |
用途 |
| ALTER |
对表进行修改,对外表元数据进行刷新。 |
| DROP |
删除表。 |
| SELECT |
查询表中数据。 |
| INSERT |
向表中导入数据。 |
| UPDATE |
更新表。 |
| EXPORT |
从 StarRocks 表中导出数据。 |
| DELETE |
按条件删除指定表中的数据,或者清空指定表的数据。 |
| ALL |
拥有对该表的上述所有权限。 |
视图权限 (VIEW)
| 权限 |
用途 |
| SELECT |
查询视图 (view) 中的数据。 |
| EXPORT |
仅支持设置/取消 EXPORT 权限,尚不支持 EXPORT TABLE。 |
| ALTER |
修改一个视图的定义。 |
| DROP |
删除一个逻辑视图。 |
| ALL |
拥有对该视图的上述所有权限。 |
物化视图权限 (MATERIALIZED VIEW)
| 权限 |
用途 |
| SELECT |
查询时引用该物化视图 (materialized view) 的数据,以加速查询。 |
| EXPORT |
仅支持设置/取消 EXPORT 权限,尚不支持 EXPORT TABLE。 |
| ALTER |
更改物化视图。 |
| REFRESH |
刷新物化视图。 |
| DROP |
删除物化视图。 |
| ALL |
拥有对该物化视图的上述所有权限。 |
库级别用户自定义函数权限 (FUNCTION)
| 权限 |
用途 |
| USAGE |
使用该函数。 |
| DROP |
删除该函数。 |
| ALL |
拥有对该函数的上述所有权限。 |
存储卷权限 (STORAGE VOLUME)
| 权限 |
用途 |
| ALTER |
更改存储卷的认证属性、注释或状态(enabled),以及设置指定存储卷为默认存储卷。 |
| DROP |
删除指定存储卷。 |
| USAGE |
查看指定存储卷的信息。 |
| ALL |
拥有对该存储卷的上述所有权限。 |
升级注意事项
从 2.x 版本升级至 3.0 版本时,由于权限系统的升级,有可能导致您的部分操作无法进行。具体包含:
| 操作 |
涉及命令 |
升级前 |
升级后 |
| 修改表 |
ALTER TABLE,CANCEL ALTER TABLE |
拥有表或表所在数据库的 LOAD_PRIV 权限即可对表执行 ALTER TABLE,CANCEL ALTER TABlE 操作 |
您需要拥有对应表的 ALTER 权限才可以执行该操作。 |
| 刷新外表 |
REFRESH EXTERNAL TABLE |
拥有外表的 LOAD_PRIV 权限即可对外表进行刷新。 |
您需要拥有对应外表的 ALTER 权限才可以对外表进行刷新。 |
| 备份与恢复 |
BACKUP,RESTORE |
拥有数据库的 LOAD_PRIV 权限即可对该数据库及其下的任意表进行备份恢复。 |
管理员需要重新对用户赋权,以保证用户可以执行BACKUP和RESTORE操作。 |
| 删除后复原 |
RECOVER 数据库或表 |
拥有对应数据库或表的 ALTER_PRIV,CREATE_PRIV,DROP_PRIV 权限即可对库或表进行复原。 |
您需要拥有 default_catalog 的 CREATE DATABASE 权限才可以恢复数据库;需要拥有对应数据库的 CREATE TABLE 和对应表的 DROP 权限。 |
| 创建、更改用户 |
CREATE USER,ALTER USER |
拥有数据库的 GRANT_PRIV 权限即可创建和更改用户。 |
您需要拥有 user_admin 角色才可以执行CREATE USER和ALTER USER操作。 |
| 授予和收回权限 |
GRANT,REVOKE |
拥有各对象的 GRANT_PRIV 权限即可将对应对象的权限授予给其他用户或角色。 |
升级后,您仍旧可以将您在该对象上已经拥有的权限赋予给其他用户或角色。 在新的权限系统中:- 拥有
user_admin 角色的用户才可以将任意权限授予给任意用户和角色。 - 当您的授权语句包含
WITH GRANT OPTION时,您可以将该语句涉及的权限授予给其他用户或角色。
|
在 2.x 版本中,StarRocks 的角色实现并不完全。当您将角色赋予给用户时,StarRocks 直接将角色所有的权限赋予给用户,而并不是将角色本身赋予给用户。从而在老版本中,StarRocks 的用户和角色并没有直接的从属关系。
升级之后,StarRocks 会对每个用户拥有的权限进行升级,老的角色仍旧存在,但仍旧与用户没有从属关系。如果您希望使用新的 RBAC,可以按照新的 GRANT 操作进行赋权。
本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。