TiDB 权限管理
Posted 79 months ago sql mysql nosql newsql tidb
title: 权限管理 category: compatibility
权限管理
TiDB的权限管理系统是按照MySQL的权限管理进行实现，大部分的MySQL的语法和权限类型都是支持的。如果发现行为跟MySQL不一致的地方，欢迎报告issue。
注意：当前版本的权限功能并没有默认开启，需要添加启动参数指定： ./tidb-server -privilege=true 如果不指定参数，权限检查不会生效。将来去掉这个参数(预计RC3)并默认启用权限检查。
1. 用户账户操作
更改密码
set password for 'root'@'%' = 'xxx';
添加用户
create user 'test'@'127.0.0.1' identified by 'xxx';
用户名是大小写敏感的。host则支持模糊匹配，比如：
create user 'test'@'192.168.10.%';
允许test用户从192.168.10子网的任何一个主机登陆。
如果没有指定host，则默认是所有IP均可登陆。如果没有指定密码，默认为空：
create user 'test';
等价于
create user 'test'@'%' identified by '';
删除用户
drop user 'test'@'%';
这个操作会清除用户在mysql.user表里面的记录项，并且清除在授权表里面的相关记录。
忘记root密码
使用一个特殊的启动参数启动TiDB（需要root权限）：
sudo ./tidb-server -skip-grant-table=true
这个参数启动，TiDB会跳过权限系统，然后使用root登陆以后修改密码：
mysql -h 127.0.0.1 -P 4000 -u root
2. 权限相关操作
授予权限
授予xxx用户对数据库test的读权限：
grant Select on test.* to 'xxx'@'%';
为test用户授予所有数据库，全部权限：
grant all privileges on *.* to 'xxx'@'%';
如果grant的目标用户不存在，TiDB会自动创建用户。
mysql> select * from mysql.user where user='xxxx';
Empty set (0.00 sec)
mysql> grant all privileges on test.* to 'xxxx'@'%' identified by 'yyyyy';
Query OK, 0 rows affected (0.00 sec)
mysql> select user,host from mysql.user where user='xxxx';
+------|------+
| user | host |
+------|------+
| xxxx | % |
+------|------+
1 row in set (0.00 sec)
例子中xxxx@%就是自动添加进去的用户。
grant对于数据库或者表的授权，不检查数据库或表是否存在。
mysql> select * from test.xxxx;
ERROR 1146 (42S02): Table 'test.xxxx' doesn't exist
mysql> grant all privileges on test.xxxx to xxxx;
Query OK, 0 rows affected (0.00 sec)
mysql> select user,host from mysql.tables_priv where user='xxxx';
+------|------+
| user | host |
+------|------+
| xxxx | % |
+------|------+
1 row in set (0.00 sec)
grant可以模糊匹配地授予数据库和表
mysql> grant all privileges on `te%`.* to genius;
Query OK, 0 rows affected (0.00 sec)
mysql> select user,host,db from mysql.db where user='genius';
+--------|------|-----+
| user | host | db |
+--------|------|-----+
| genius | % | te% |
+--------|------|-----+
1 row in set (0.00 sec)
这个例子中通过%模糊匹配，所有te开头的数据库，都被授予了权限。
收回权限
revoke语句与grant对应：
revoke all privileges on `test`.* from 'genius'@'localhost';
注意revoke收回权限时只做精确匹配，若找不到记录则报错。而grant授予权限时可以使用模糊匹配。
mysql> revoke all privileges on `te%`.* from 'genius'@'%';
ERROR 1141 (42000): There is no such grant defined for user 'genius' on host '%'
关于模糊匹配和转义，字符串和identifier
mysql> grant all privileges on `te\%`.* to 'genius'@'localhost'; Query OK, 0 rows affected (0.00 sec)这个例子是精确匹配名叫te%的数据库，注意到用了\转义字符。
以单引号包含的，是一个字符串。以反引号包含的，是一个identifier。注意下面区别：
mysql> grant all privileges on 'test'.* to 'genius'@'localhost'; ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ''test'.* to 'genius'@'localhost'' at line 1 mysql> grant all privileges on `test`.* to 'genius'@'localhost'; Query OK, 0 rows affected (0.00 sec)如果一些特殊的关键字想做为表名，可以用反引号包含起来。比如：
mysql> create table `select` (id int); Query OK, 0 rows affected (0.27 sec)
查看为用户分配的权限
show grant语句可以查看为用户分配了哪些权限。
show grants for 'root'@'%';
更精确的方式，可以通过直接查看授权表的数据实现。比如想知道，test@%该用户是否拥有对db1.t的Insert权限。
先查看该用户是否拥有全局Insert权限：
select Insert from mysql.user where user='test' and host='%';
如果没有，再查看该用户是否拥有db1数据库级别的Insert权限：
select Insert from mysql.db where user='test' and host='%';
如果仍然没有，则继续判断是否拥有db1.t这张表的Insert权限：
select tables_priv from mysql.tables_priv where user='test' and host='%' and db='db1';
3. 权限系统的实现
授权表
有几张系统表是非常特殊的表，权限相关的数据全部存储在这几张表内。
- mysql.user 用户账户，全局权限
- mysql.db 数据库级别的权限
- mysql.tables_priv 表级别的权限
- mysql.columns_priv 列级别的权限
这几张表包含了数据的生效范围和权限信息。例如，mysql.user表的部分数据：
mysql> select User,Host,Select_priv,Insert_priv from mysql.user limit 1;
+------|------|-------------|-------------+
| User | Host | Select_priv | Insert_priv |
+------|------|-------------|-------------+
| root | % | Y | Y |
+------|------|-------------|-------------+
1 row in set (0.00 sec)
这条记录中，Host和User决定了root用户从任意主机（%）发送过来的连接请求可以被接受，而Select_priv和Insert_priv表示用户拥有全局的Select和Insert权限。mysql.user这张表里面的生效范围是全局的。
mysql.db表里面包含的Host和User决定了用户可以访问哪些数据库，权限列的生效范围是数据库。
理论上，所有权限管理相关的操作，都可以通过直接对授权表的CRUD操作完成。
实现层面其实也只是包装了一层语法糖。例如删除用户会执行：
delete from mysql.user where user='test';
但是不推荐用户手动修改授权表。
连接验证
当客户端发送连接请求时，TiDB服务器会对登陆操作进行验证。验证过程先检查mysql.user表，当某条记录的User和Host和连接请求匹配上了，再去验证Password。用户身份基于两部分信息，发起连接的客户端的Host，以及用户名User。如果User不为空，则用户名必须精确匹配。
User+Host可能会匹配user表里面多行，为了处理这种情况，user表的行是排序过的，客户端连接时会依次去匹配，并使用首次匹配到的那一行做权限验证。排序是按Host在前，User在后。
请求验证
连接成功之后，请求验证会检测执行操作是否拥有足够的权限。
对于数据库相关请求(INSERT，UPDATE)，先检查mysql.user表里面的用户全局权限，如果权限够，则直接可以访问。如果全局权限不足，则再检查mysql.db表。
user表的权限是全局的，并且不管默认数据库是哪一个。比如user里面有DELETE权限，任何一行，任何的表，任何的数据库。
db表里面，User为空是匹配匿名用户，User里面不能有通配符。Host和Db列里面可以有%和_，可以模式匹配。
user和db读到内存也是排序的。
tables_priv 和 columns_priv 中使用%是类似的，但是在Db, Table_name, Column_name 这些列不能包含%。加载进来时排序也是类似的。
生效时机
TiDB启动时，将一些权限检查的表加载到内存，之后使用缓存的数据来验证权限。系统会周期性的将授权表从数据库同步到缓存，生效则是由同步的周期决定，目前这个值设定的是5分钟。
修改了授权表，如果需要立即生效，可以手动调用：
flush privileges;
4. 限制和约束
一些使用频率偏低的权限当前版本的实现中还未做检查，比如FILE/USAGE/SHUTDOWN/EXECUTE/PROCESS/INDEX等等，未来会陆续完善。
现阶段对权限的支持还没有做到column级别。