MySQL查询重写插件的使用

查询重写插件

从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：