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");

查询刚刚插入的规则：

输出的规则每一列的内容如下：

重写器查询重写插件过程

将规则添加到 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值必须 与加载规则表时的全局值相同，否则规则匹配将不适用于该客户端。