MySQL查询重写插件的使用
作者:AsiaYe 时间:2024-01-27 15:55:58
查询重写插件
从MySQL 5.7.6开始,MySQL Server支持查询重写插件,可以在服务器执行之前检查并可能修改服务器接收的语句。
以下是官方文档介绍:
预解析重写插件具有以下特点:
1.该插件允许在服务器处理之前重写到达服务器的SQL语句。
2.该插件接收一个语句字符串,并可能返回一个不同的字符串。
后解析查询重写插件具有以下特征:
1.该插件支持基于解析树的语句重写。
2.服务器解析每个语句并将其解析树传递给插件,插件可以遍历树。插件可以将原始树返回到服务器以进行进一步处理,或者构造不同的树并返回该树。
通俗来讲,是指该插件支持两种重写方式,一种是在语法解析之前,直接修改SQL字符串,一种是在语法解析之后,通过操控语法解析树来进行重写。这个特性还是非常有用的,例如错误的上线了某个SQL,但由于无法走到索引导致全库查询; 或者你可能使用某个第三方的已编译好的软件,但SQL可能执行错误,你又无法直接修改应用,这个特性将会非常有用,还可以去编写符合用户要求的插件。
安装或卸载
最简单的安装过程如下:
shell> mysql -u root -p < install_rewriter.sql Enter password: (enter root password here)
可以发现,在数据库中多增加了一个库query_rewrite,查看该数据库:
查看插件当前是否安装:
实践操作
例如为如下语句强制使用主键查询:
SELECT DBA_no, name from DBA_inf where DBA_no = ?
改写成:
SELECT DBA_no, name from DBA_inf force index(primary) where DBA_no = ?
要为Rewriter插件添加规则,具体步骤分为两步:
1.向rewrite_rules表中添加相应的规则;
2.调用flush_rewrite_rules()存储过程以将表中的规则加载到插件中。
以下示例创建一个简单规则来匹配选择单个文字值的语句,执行的操作:
insert into query_rewrite.rewrite_rules(pattern, replacement, pattern_database) values ("SELECT DBA_no, name from DBA_inf where DBA_no = ?","SELECT DBA_no, name from DBA_inf force index(primary) where DBA_no = ?","DBAs");
查询刚刚插入的规则:
输出的规则每一列的内容如下:
id: | 规则ID。此列是表主键。可以使用该ID唯一标识任何规则。 |
---|---|
pattern: | 指示规则匹配的语句模式的模板,使用?表示匹配的数据值。 |
pattern_database: | 该数据库用于匹配语句中的非限定表名。如果相应的数据库和表名相同,则语句中的限定表名与模式中的限定名匹配;当默认数据库pattern_database与表名相同且语句名相同时,语句中的非限定表名才匹配模式中的非限定名称 。 |
replacement: | 指示如何重写与pattern列值匹配的语句的模板。使用 ?表示匹配的数据值,?是参数标记,实际语句中可以替换。 |
enabled: | 规则是否已启用。加载操作(通过调用flush_rewrite_rules() 存储过程执行)Rewriter仅在此列加载时才将表中的规则加载到 内存缓存中YES。此列可以在不删除规则的情况下停用规则:将列设置为除YES表之外的值 ,然后将表重新加载到插件中。 |
message: | 该插件使用此列与用户进行通信。如果将规则表加载到内存中时没有发生错误,则插件会将message 列设置为NULL。非NULL值表示错误,列内容是错误消息。在这些情况下可能会发生错误:1.模式或替换是一个产生语法错误的错误SQL语句。2.替换包含比模式更多的参数标记。如果发生加载错误,插件还会将 Rewriter_reload_error状态变量设置为ON。 |
pattern_digest: | 此列用于调试和诊断。如果在将规则表加载到内存中时该列存在,则插件会使用模式摘要更新它。此列可帮助确定某些语句无法重写的原因。 |
normalized_pattern | 此列用于调试和诊断。如果在将规则表加载到内存中时该列存在,则插件会使用模式的规范化形式对其进行更新。如果您尝试确定某些语句无法重写的原因,则此列可能很有用。 |
重写器查询重写插件过程
将规则添加到 rewrite_rules表中不足以使Rewriter插件使用该规则。还必须调用flush_rewrite_rules()以将表内容加载到插件内存缓存中:
Rewriter插件操作使用存储过程将规则表加载到其内存缓存中,在正常操作下,用户仅调用flush_rewrite_rules()从而将rewrite_rules表的内容加载到Rewriter内存高速缓存中。加载表后,它还会清除查询缓存。
当修改规则表后,需要重新调用此过程以使插件从新表内容更新其缓存:
使用重写插件中定义的语句模式查询相应记录:
SELECT DBA_no, name from DBA_inf where DBA_no =8;
通过使用explain语句查看,当前SQL已经使用了索引
重写插件操作信息
该Rewriter插件通过几个状态变量提供有关其操作的信息:
有关这些变量的说明:
Rewriter_number_loaded_rules:成功从rewrite_rules表中加载到内存中以供Rewriter 插件使用的重写插件重写规则的数量。
Rewriter_number_reloads:rewrite_rules被加载到Rewriter插件缓存中的次数。
Rewriter_number_rewritten_queries:Rewriter查询重写插件自加载以来重写的查询数 。
Rewriter_reload_error:是否在最近将rewrite_rules表加载到Rewriter 插件使用的内存高速缓存中时发生错误 。如果值为OFF,则不会发生错误。如果值为,则ON发生错误;检查表的message列rewriter_rules是否有错误消息。
通过调用flush_rewrite_rules()存储过程加载规则表时 ,如果某些规则发生错误,则该CALL 语句会产生错误,并且该插件会将 Rewriter_reload_error状态变量设置为ON:
在这种情况下,请检查rewrite_rules表中是否包含非NULL message列值的行,以查看存在的问题。
重写器插件使用字符集
当rewrite_rules表加载到Rewriter插件中时,插件使用character_set_client系统变量的当前全局值来解释语句 。如果character_set_client随后更改全局 值,则必须重新加载规则表。
客户端的会话character_set_client值必须 与加载规则表时的全局值相同,否则规则匹配将不适用于该客户端。
来源:https://cloud.tencent.com/developer/article/1533507