GRANT

引入或更新于：v1.2.275

授予特定数据库对象的权限、角色和所有权。包括：

• 授予用户或角色权限。
• 将角色分配给用户或其他角色。
• 将所有权转移给角色。

另请参阅：

• REVOKE
• SHOW GRANTS

语法

授予权限

要了解什么是权限及其工作原理，请参阅权限。

GRANT { 
        schemaObjectPrivileges | ALL [ PRIVILEGES ] ON <privileges_level>
      }
TO [ ROLE <role_name> ] [ <user_name> ]

其中：

schemaObjectPrivileges ::=
-- 对于 TABLE
  { SELECT | INSERT }
  
-- 对于 SCHEMA
  { CREATE | DROP | ALTER }
  
-- 对于 USER
  { CREATE USER }
  
-- 对于 ROLE
  { CREATE ROLE}
  
-- 对于 STAGE
  { READ, WRITE }
           
-- 对于 UDF
  { USAGE }

privileges_level ::=
    *.*
  | db_name.*
  | db_name.tbl_name
  | STAGE <stage_name>
  | UDF <udf_name>

授予角色

要了解什么是角色及其工作原理，请参阅角色。

-- 将角色授予用户
GRANT ROLE <role_name> TO <user_name>

-- 将角色授予角色
GRANT ROLE <role_name> TO ROLE <role_name>

授予所有权

要了解什么是所有权及其工作原理，请参阅所有权。

-- 将数据库中特定表的所有权授予角色
GRANT OWNERSHIP ON <database_name>.<table_name> TO ROLE '<role_name>'

-- 将 stage 的所有权授予角色
GRANT OWNERSHIP ON STAGE <stage_name> TO ROLE '<role_name>'

-- 将用户定义函数 (UDF) 的所有权授予角色
GRANT OWNERSHIP ON UDF <udf_name> TO ROLE '<role_name>'

示例

示例 1：授予用户权限

创建用户：

CREATE USER user1 IDENTIFIED BY 'abc123';

将 default 数据库中所有现有表的 ALL 权限授予用户 user1：

GRANT ALL ON default.* TO user1;

SHOW GRANTS FOR user1;
+-----------------------------------------+
| Grants                                  |
+-----------------------------------------+
| GRANT ALL ON 'default'.* TO 'user1'@'%' |
+-----------------------------------------+

将所有数据库的 ALL 权限授予用户 user1：

GRANT ALL ON *.* TO 'user1';

SHOW GRANTS FOR user1;
+-----------------------------------------+
| Grants                                  |
+-----------------------------------------+
| GRANT ALL ON 'default'.* TO 'user1'@'%' |
| GRANT ALL ON *.* TO 'user1'@'%'         |
+-----------------------------------------+

将名为 s1 的 stage 的 ALL 权限授予用户 user1：

GRANT ALL ON STAGE s1 TO 'user1';

SHOW GRANTS FOR user1;
+-----------------------------------------------------------------+
| Grants                                                          |
+-----------------------------------------------------------------+
| GRANT ALL ON STAGE s1 TO 'user1'@'%'                            |
| GRANT SELECT ON 'default'.'system'.'one' TO 'user1'@'%'         |
| GRANT SELECT ON 'default'.'information_schema'.* TO 'user1'@'%' |
+-----------------------------------------------------------------+

将名为 f1 的 UDF 的 ALL 权限授予用户 user1：

GRANT ALL ON UDF f1 TO 'user1';

SHOW GRANTS FOR user1;
+-----------------------------------------------------------------+
| Grants                                                          |
+-----------------------------------------------------------------+
| GRANT ALL ON UDF f1 TO 'user1'@'%'                              |
| GRANT SELECT ON 'default'.'system'.'one' TO 'user1'@'%'         |
| GRANT SELECT ON 'default'.'information_schema'.* TO 'user1'@'%' |
+-----------------------------------------------------------------+

示例 2：授予角色权限

将 mydb 数据库中所有现有表的 SELECT 权限授予角色 role1：

创建角色：

CREATE ROLE role1;

将权限授予角色：

GRANT SELECT ON mydb.* TO ROLE role1;

显示角色的权限：

SHOW GRANTS FOR ROLE role1;
+-------------------------------------+
| Grants                              |
+-------------------------------------+
| GRANT SELECT ON 'mydb'.* TO 'role1' |
+-------------------------------------+

示例 3：将角色授予用户

用户 user1 的权限：

SHOW GRANTS FOR user1;
+-----------------------------------------+
| Grants                                  |
+-----------------------------------------+
| GRANT ALL ON 'default'.* TO 'user1'@'%' |
| GRANT ALL ON *.* TO 'user1'@'%'         |
+-----------------------------------------+

角色 role1 的权限：

SHOW GRANTS FOR ROLE role1;
+-------------------------------------+
| Grants                              |
+-------------------------------------+
| GRANT SELECT ON 'mydb'.* TO 'role1' |
+-------------------------------------+

将角色 role1 授予用户 user1：

 GRANT ROLE role1 TO user1;

现在，用户 user1 的权限：

SHOW GRANTS FOR user1;
+-----------------------------------------+
| Grants                                  |
+-----------------------------------------+
| GRANT ALL ON 'default'.* TO 'user1'@'%' |
| GRANT ALL ON *.* TO 'user1'@'%'         |
| GRANT SELECT ON 'mydb'.* TO 'role1'     |
+-----------------------------------------+

示例 4：将所有权授予角色

-- 将 'finance_data' 数据库中所有表的所有权授予角色 'data_owner'
GRANT OWNERSHIP ON finance_data.* TO ROLE 'data_owner';

-- 将 'finance_data' 模式中的表 'transactions' 的所有权授予角色 'data_owner'
GRANT OWNERSHIP ON finance_data.transactions TO ROLE 'data_owner';

-- 将 stage 'ingestion_stage' 的所有权授予角色 'data_owner'
GRANT OWNERSHIP ON STAGE ingestion_stage TO ROLE 'data_owner';

-- 将用户定义函数 'calculate_profit' 的所有权授予角色 'data_owner'
GRANT OWNERSHIP ON UDF calculate_profit TO ROLE 'data_owner';