MySQL 如何批量导出所有用户权限?用 pt-show-grants 规范化后才能进版本库
一、为什么 SHOW GRANTS 的输出不能直接进版本库
Percona Toolkit 官方文档对 pt-show-grants 的定位是一句话:
pt-show-grants - Canonicalize and print MySQL grants so you can effectively replicate, compare and version-control them.
「canonicalize(规范化)」这个词是核心。文档解释得很直白:MySQL 打印授权时的顺序是看似随机的,同一条权限今天长这样:
GRANT DELETE, INSERT, UPDATE ON `test`.* TO 'foo'@'%';
明天变成这样:
GRANT INSERT, DELETE, UPDATE ON `test`.* TO 'foo'@'%';
权限一个字没改,只是顺序变了。如果你把 SHOW GRANTS 的原始输出每天自动倒进 Git,就会出现文档里说的「lots of spurious changesets」(大量虚假变更集),代码评审被淹没,diff 也失去意义。
官方明确说了工具解决的是三层不一致:
The grants haven't changed, but the order has. This script sorts the grants within the line, between 'GRANT' and 'ON'. If there are multiple rows from SHOW GRANTS, it sorts the rows too, except that it always prints the row with the user's password first, if it exists. This removes three kinds of inconsistency you'll get from running SHOW GRANTS, and avoids spurious changesets in version control.
三条排序规则值得逐条记住:
- 行内排序:只对
GRANT与ON之间的权限词列表排序。 - 行间排序:多个
SHOW GRANTS结果行也排序。 - 例外:带密码的那一行永远排在最前(如果存在)。这条很重要,因为它保证了密码行位置稳定,diff 不会因为排序而把密码行漂走。

二、三个真实用途,官方是这么列的
文档给的动机有三条:
- 跨服务器复制用户:从 A 库导出,直接把管道输出灌进 B 库。
- 进版本库做审计:配合上面的排序,变更集才有意义。
- 跨服务器 diff:不做规范化时两个服务器的授权几乎不可能对齐;规范化后「output is fully diff-able」。文档给的典型用法就是这一行:
pt-show-grants --separate --revoke | diff othergrants.sql -
这条命令值得拆开看:--separate 让输出按用户分开,--revoke 生成回收语句,然后与另一台服务器导出的文件做 diff。生产环境做「测试库与生产库权限是否漂移」的核对,这是最短路径。
文档还提到一个反直觉的点:手动回收某些权限是「tedious」(极其繁琐)的,配合 --revoke 与 --separate 就变成可脚本化的操作。
三、常用参数与它们的真实语义
从官方选项表里挑生产最常用的:
--separate:按用户分离输出,便于逐个 diff / 回滚。--revoke:输出回收权限语句,而不是授予语句。--drop:在每个用户前加DROP USER,用于彻底重建。--flush:在输出末尾追加FLUSH PRIVILEGES。文档给了限定条件:在 4.1.1 之前的服务器上,若要彻底删除用户才可能需要。--ask-pass:连接时提示输入密码,避免密码进 shell history。--charset(短-A):官方说明值得留意 —— 值为utf8时,会对 STDOUT 设置 Perl 的 binmode、给 DBD::mysql 传mysql_enable_utf8,并在连接后执行SET NAMES UTF8;其他值则不带 utf8 层执行SET NAMES。--[no]buffer-stdout(默认 yes):文档提醒,若要配合tee、kubectl logs这类后处理看实时进度,需要把它关掉。--defaults-file(短-F):只从指定文件读 mysql 选项,且必须给绝对路径。- MariaDB 互转:
--convert-from-mariadb/--convert-to-mariadb,异构环境迁移时省掉手工改语法。
连接目标用 DSN 形式指定,基本用法:
pt-show-grants --ask-pass h=127.0.0.1,P=3306,u=root > grants.sql pt-show-grants --flush --ask-pass | mysql -u root -h target-host
四、别忽略文档里的 RISKS 与 ATTENTION 段落
Percona 在每个工具前都放了一段标准风险提示,原文:
Percona Toolkit is mature, proven in the real world, and well tested, but all database tools can pose a risk to the system and the database server. Before using this tool, please: Read the tool's documentation Review the tool's known "BUGS" Test the tool on a non-production server Backup your production server and verify the backups
其中「先备份并验证备份」这条最容易被跳过。落到 pt-show-grants 上,真正的风险点是这几个:
- 把
--drop的输出直接灌进目标库:等于先删用户再建用户,中间失败就会留下一堆无权限账号。 - 把导出文件当唯一真相源:授权变更没走版本库,回滚时只能靠这份文本,一旦漏提交就永久丢失。
- 密码行处理:文档说带密码行总是排在最前,方便识别,但这类文件必须当密钥管理,不能进公开仓库。
- 角色相关:选项表里有
--[no]include-unused-roles,说明「未被使用的角色」默认行为与预期可能不同,做角色审计时要显式指定。
五、把它接进日常流程的做法
# 每天凌晨导出全部权限并归档,Git 只记录真实变更 pt-show-grants --ask-pass --flush h=db-prod,P=3306 \ | gzip > /backup/grants/$(date +\%F).sql.gz
三个可复核的收益:
- 审计:任何一条权限变动都能在 Git 里定位到提交与时间。
- 灾备:实例重建时不需要回忆「当时给过谁什么权限」。
- 对齐:测试库与生产库一条 diff 命令就能看出差异。
参考来源:Percona Toolkit 官方文档《pt-show-grants》。
生产内容,同时打通搜索引擎(SEO)与AI搜索引擎(GEO)流量入口的软件! 点击进入365建站器 »
