CREATE ROLE

CREATE ROLE 语句是基于角色的访问控制 (RBAC) 操作的一部分，用于创建新角色并将新角色分配给用户。

语法图

CreateRoleStmt

CREATE ROLE - 图1

IfNotExists

CREATE ROLE - 图2

RoleSpec

CREATE ROLE - 图3

1. CreateRoleStmt ::=
2. 'CREATE' 'ROLE' IfNotExists RoleSpec (',' RoleSpec)*

4. IfNotExists ::=
5. ('IF' 'NOT' 'EXISTS')?

7. RoleSpec ::=
8. Rolename

示例

以 root 用户连接 TiDB：

1. mysql -h 127.0.0.1 -P 4000 -u root

创建新角色 analyticsteam 和新用户 jennifer：

1. CREATE ROLE analyticsteam;
2. Query OK, 0 rows affected (0.02 sec)

4. GRANT SELECT ON test.* TO analyticsteam;
5. Query OK, 0 rows affected (0.02 sec)

7. CREATE USER jennifer;
8. Query OK, 0 rows affected (0.01 sec)

10. GRANT analyticsteam TO jennifer;
11. Query OK, 0 rows affected (0.01 sec)

以 jennifer 用户连接 TiDB：

1. mysql -h 127.0.0.1 -P 4000 -u jennifer

需要注意的是，默认情况下，用户 jennifer 需要执行 SET ROLE analyticsteam 语句才能使用与 analyticsteam 角色相关联的权限：

1. SHOW GRANTS;
2. +---------------------------------------------+
3. | Grants for User                             |
4. +---------------------------------------------+
5. | GRANT USAGE ON *.* TO 'jennifer'@'%'        |
6. | GRANT 'analyticsteam'@'%' TO 'jennifer'@'%' |
7. +---------------------------------------------+
8. 2 rows in set (0.00 sec)

10. SHOW TABLES in test;
11. ERROR 1044 (42000): Access denied for user 'jennifer'@'%' to database 'test'
12. SET ROLE analyticsteam;
13. Query OK, 0 rows affected (0.00 sec)

15. SHOW GRANTS;
16. +---------------------------------------------+
17. | Grants for User                             |
18. +---------------------------------------------+
19. | GRANT USAGE ON *.* TO 'jennifer'@'%'        |
20. | GRANT SELECT ON test.* TO 'jennifer'@'%'    |
21. | GRANT 'analyticsteam'@'%' TO 'jennifer'@'%' |
22. +---------------------------------------------+
23. 3 rows in set (0.00 sec)

25. SHOW TABLES IN test;
26. +----------------+
27. | Tables_in_test |
28. +----------------+
29. | t1             |
30. +----------------+
31. 1 row in set (0.00 sec)

以 root 用户连接 TiDB：

1. mysql -h 127.0.0.1 -P 4000 -u root

执行 SET DEFAULT ROLE 语句将用户 jennifer 与 analyticsteam 角色相关联：

1. SET DEFAULT ROLE analyticsteam TO jennifer;
2. Query OK, 0 rows affected (0.02 sec)

以 jennifer 用户连接 TiDB：

1. mysql -h 127.0.0.1 -P 4000 -u jennifer

此时 jennifer 用户无需执行 SET ROLE 语句就能拥有 analyticsteam 角色相关联的权限：

1. SHOW GRANTS;
2. +---------------------------------------------+
3. | Grants for User                             |
4. +---------------------------------------------+
5. | GRANT USAGE ON *.* TO 'jennifer'@'%'        |
6. | GRANT SELECT ON test.* TO 'jennifer'@'%'    |
7. | GRANT 'analyticsteam'@'%' TO 'jennifer'@'%' |
8. +---------------------------------------------+
9. 3 rows in set (0.00 sec)

11. SHOW TABLES IN test;
12. +----------------+
13. | Tables_in_test |
14. +----------------+
15. | t1             |
16. +----------------+
17. 1 row in set (0.00 sec)

MySQL 兼容性

CREATE ROLE 语句与 MySQL 8.0 的“角色”功能完全兼容。如发现任何兼容性差异，请尝试 TiDB 支持资源。

另请参阅