编程 向 rewrite_rules 插入 SELECT ? 后,SELECT 10 仍返回 10:MySQL Rewriter 的加载与匹配判据

2026-11-22 00:04:26

向 rewrite_rules 插入 SELECT ? 后,SELECT 10 仍返回 10:MySQL Rewriter 的加载与匹配判据

在 MySQL 8.4 上按手册插入一条规则:

INSERT INTO query_rewrite.rewrite_rules (pattern, replacement)
VALUES('SELECT ?','SELECT ? + 1');

然后执行 SELECT 10;,返回的仍是 10,而且没有警告。query_rewrite.rewrite_rules 里那行数据确实存在,enabled 也是默认的 YES。问题不在 SQL 写法,而在“表里已经有这行记录”和“插件内存里已经加载了这条规则”是两件事。

Rewriter 是 post-parse(解析后)查询重写插件,随 MySQL 发行版提供。它关心的语句是 SELECT、INSERT、REPLACE、UPDATE、DELETE。独立语句与 prepared statement 都会被改写,但 prepared statement 是在 prepare 阶段改写,不是在执行阶段。视图定义内、存储程序内的语句不会被改写。这几条决定了“哪些语句根本进不了改写流程”。

判据与排查顺序

第一步:确认是否真的加载过。 改表不等于生效。修改 rewrite_rules 后必须执行:

CALL query_rewrite.flush_rewrite_rules();

这个过程把表内容装入插件内存缓存,内部调用可加载函数 load_rewrite_rules();并且 flush_rewrite_rules() 隐含 COMMIT(和 FLUSH TABLE 类似)。没调用过它,规则只在磁盘上。文档也明确提示:规则看起来不生效时,先确认是否调用过 flush_rewrite_rules()。

第二步:看 message 列和错误码。 加载成功时 message 为 NULL;非 NULL 就是错误文本。触发错误的两种情形是:pattern 或 replacement 不是合法 SQL;replacement 里的 ? 参数标记数量多于 pattern。这时 flush 会报:

ERROR 1644 (45000): Loading of some rule(s) failed

同时状态变量 Rewriter_reload_error 变为 ON。所以先 SELECT id, pattern, replacement, enabled, message FROM query_rewrite.rewrite_rules;,再 SHOW STATUS LIKE 'Rewriter_%';,比反复试 SQL 快。

第三步:确认 enabled 是否参与加载。 只有 enabled='YES' 的规则才会在加载时进入内存。停用规则可以 UPDATE ... SET enabled='NO',不必删除。改完同样要 flush。

第四步:对照语句形态。 语句里的表名写法会影响匹配:pattern_database 只用于匹配未带库名的表名。语句里写 db.t 这种限定名时,只有库名和表名都对上才匹配;写未限定表名时,要求客户端默认库等于 pattern_database 且表名相同。因此同一条业务 SQL 的“带库名”和“不带库名”两种写法需要两条规则,第二条还要填 pattern_database。

第五步:检查全局字符集是否与加载时一致。 加载规则表时,插件用当时的全局 character_set_client 解释语句;之后全局值改变就必须重新加载。并且客户端的 session character_set_client 必须与加载时的全局值一致,否则该客户端的规则匹配不工作。这条在多客户端环境里最容易被忽略。

第六步:确认改写是否发生。 改写发生时会产生一条 Note 级警告,Code 1105,Message 形如:

Query 'SELECT 10' rewritten to 'SELECT 10 + 1' by a query rewrite plugin

可以用它审计。反过来说,没有 1105 就说明没改写,不必再猜结果对不对。

匹配本身分三段:先算语句 digest hash,与各规则的 pattern_digest 比较(快速拒绝,可能误报命中);命中后比较 normalized_pattern 与语句的 normalized form(statement digest);最后逐字面值比较,pattern 中的 ? 匹配任意字面值。若语句是 prepared,pattern 的 ? 只能匹配语句中的 ?。max_digest_length 决定 digest 缓冲区大小:值越大越能区分长语句;越小越省内存,但长语句更容易撞同一 digest。默认 1024 字节,以 SHOW VARIABLES LIKE 'max_digest_length'; 为准。

默认值与常量

项值 / 行为
rewrite_rules 列id(主键)、pattern、pattern_database、replacement、enabled、message、pattern_digest、normalized_pattern
enabled必须为 YES 才在加载时进入内存;NO 可停用而不删除
message加载成功为 NULL;非 NULL 为错误文本
max_digest_length默认 1024 字节,以 SHOW VARIABLES LIKE 'max_digest_length'; 为准
rewriter_enabled默认 ON,全局、动态;SET_VAR hint 不适用
rewriter_enabled_for_threads_without_privilege_checks默认 ON;设为 OFF 后,拥有 SKIP_QUERY_REWRITE 权限的用户的语句才会被跳过改写。设置该变量需 SYSTEM_VARIABLES_ADMIN 或 SUPER
加载失败ERROR 1644 (45000): Loading of some rule(s) failed,Rewriter_reload_error 变 ON
改写的警告Note 级,Code 1105
状态变量Rewriter_number_loaded_rules、Rewriter_number_reloads、Rewriter_number_rewritten_queries、Rewriter_reload_error

注意最后一个默认值 ON 的后果:不做权限检查的线程(复制线程等)也会走改写。只有把 rewriter_enabled_for_threads_without_privilege_checks 设为 OFF,拥有 SKIP_QUERY_REWRITE 权限的用户语句才会被跳过。

互斥与失效点

多条规则同时匹配同一语句时,用哪条改写是不确定的(nondeterministic),因此规则必须互斥。插入规则前先用 pattern 交叉验证,别指望“后插入的覆盖先插入的”。

? 的数量不对称只在一个方向报错:replacement 的 ? 多于 pattern 是错误;反过来 pattern 的 ? 多于 replacement 不报错,多余匹配到的数据值被丢弃。这也是“加载没报错但结果不对”的一个来源。

改写不要求语句类型相同。手册示例把

DELETE FROM db1.t1 WHERE col=?

改成

UPDATE db1.t1 SET col=NULL WHERE col=?

这类跨语句类型的替换能加载成功,也能通过 flush 的检查,判断规则是否生效只能靠 1105 警告和实际执行结果。

最小可复现路径就是手册里那条:

INSERT INTO query_rewrite.rewrite_rules (pattern, replacement)
VALUES('SELECT ?','SELECT ? + 1');
CALL query_rewrite.flush_rewrite_rules();

之后 SELECT 10 返回 11 并带 1105 警告。若返回 10,按上面的顺序回查:flush 有没有执行、message 是否为 NULL、enabled 是否为 YES、pattern_database 与限定名是否对得上、全局 character_set_client 是否变过。这几条都过了还没有 1105,再去看 max_digest_length 与规则之间的互斥情况。

项目地址

  • 概览:https://dev.mysql.com/doc/refman/8.4/en/rewriter-query-rewrite-plugin.html
  • 使用:https://dev.mysql.com/doc/refman/8.4/en/rewriter-query-rewrite-plugin-usage.html
  • 参考:https://dev.mysql.com/doc/refman/8.4/en/rewriter-query-rewrite-plugin-reference.html

本篇与站内 #8681 MySQL hypergraph optimizer 开关、#8700 锁等待链的区别:这里讲的是解析之后、优化之前的语句改写层。

推荐文章

程序员茄子在线接单