使用中间件proxysql实现mysql读写分离

今天药忘吃喽~ 2022-11-27 06:29 165阅读 0赞

### 使用中间件proxysql实现mysql读写分离 ###

*  1. mysql实现读写分离的方式
 *  2.ProxySQL简介
 *  3. proxysql安装
 *  4. ProxySQL的Admin管理接口
 *  5. 和admin管理接口相关的变量
 *   *   *  5.1 admin-admin\_credentials
         *  5.2 admin-stats\_credentials
         *  5.3 admin-mysql\_ifaces
 *  6. 多层配置系统
 *   *   *  6.1 proxysql的库
         *  6.2 ProxySQL多层配置系统
         *  6.3 proxysql各张表的含义
         *  6.4 proxysql核心表
         *   *   *  mysql\_servers
                 *  mysql\_users
                 *  mysql\_query\_rules
         *  6.5 启动ProxySQL时如何加载配置
 *  7. 不同类型的读写分离方案解析
 *   *   *  7.1 最简单的读写分离架构
         *  7.2 多个读组或写组的分离模式
 *  8. 使用proxysql实现读写分离
 *   *   *  添加主机到 mysql\_servers 表中
         *  添加增删改查的账号到mysql\_users
         *  添加健康检测的帐号
         *  添加读写分离的路由规则到mysql\_query\_rules
     *  验证mysql读写分离
     *   *  验证读写分离是否成功

# 1. mysql实现读写分离的方式 #

--------------------

**mysql 实现读写分离的方式有以下几种：**

*  *程序修改mysql操作，直接和数据库通信，简单快捷的读写分离和随机的方式实现的负载均衡，权限独立分配，需要开发人员协助。*  
     
 *  *amoeba，直接实现读写分离和负载均衡，不用修改代码，有很灵活的数据解决方案，自己分配账户，和后端数据库权限管理独立，权限处理不够灵活。*  
     
 *  *mysql-proxy，直接实现读写分离和负载均衡，不用修改代码，master和slave用一样的帐号，效率低*  
       
    *mycat中间件*  
     
 *  ***proxysql中间件（推荐使用）***

# 2.ProxySQL简介 #

--------------------

ProxySQL 是一款可以实际用于生产环境的 MySQL 中间件，它有官方版和 percona 版两种。percona版是在官方版的基础上修改的，添加了几个比较实用的工具。生产环境使用官方版。  
   
ProxySQL 是用 C++ 语言开发的，虽然也是一个轻量级产品，但性能很好(据测试，能处理千亿级的数据)，功能也足够，能满足中间件所需的绝大多数功能，包括：

*  **最基本的读/写分离，且方式有多种**
 *  可定制基于用户、基于schema、基于语句的规则对SQL语句进行路由。换句话说，规则很灵活。基于schema和与语句级的规则，可以实现简单的sharding(分库分表)
 *  可缓存查询结果。虽然ProxySQL的缓存策略比较简陋，但实现了基本的缓存功能，绝大多数时候也够用了。
 *  监控后端节点。ProxySQL可以监控后端节点的多个指标，包括：ProxySQL和后端的心跳信息，后端节点的read-only/read-write，slave和master的数据同步延迟性(replication lag)

# 3. proxysql安装 #

--------------------

[root@zyy180 ~]# ls
    anaconda-ks.cfg  proxysql-2.0.13-1-centos7.x86_64.rpm
    
    
    
    
    
    下载proxysql
    [root@zyy180 ~]# yum -y localinstall proxysql-2.0.13-1-centos7.x86_64.rpm 
    
    
    
    
    
    开启服务
    [root@zyy180 ~]# systemctl enable proxysql
    [root@zyy180 ~]# systemctl start proxysql
    [root@zyy180 ~]# ss -anlt
    State      Recv-Q Send-Q Local Address:Port               Peer Address:Port              
    LISTEN     0      128             *:6032                        *:*                  
    LISTEN     0      128             *:6033                        *:*                  
    LISTEN     0      128             *:6033                        *:*                  
    LISTEN     0      128             *:6033                        *:*                  
    LISTEN     0      128             *:6033                        *:*                  
    LISTEN     0      128             *:22                          *:*                  
    LISTEN     0      100     127.0.0.1:25                          *:*                  
    LISTEN     0      128            :::22                         :::*                  
    LISTEN     0      100           ::1:25                         :::*         
    
    
    
    
    
    安装mariadb，需要mysql命令登录
    [root@zyy180 ~]# yum -y install mariadb

# 4. ProxySQL的Admin管理接口 #

--------------------

**当 ProxySQL 启动后，将监听两个端口：**

*  admin管理接口，默认端口为6032。该端口用于查看、配置ProxySQL(管理proxysql)
 *  接收SQL语句的接口，默认端口为6033，这个接口类似于MySQL的3306端口(管理后端mysql服务器)  
       
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3p5eTEzMDk4OA_size_16_color_FFFFFF_t_70_pic_center]

ProxySQL 的 admin 管理接口是一个使用 MySQL 协议的接口，所以，可以直接使用 mysql 客户端、navicat 等工具去连接这个管理接口，其默认的用户名和密码均为 admin  
   
   
**默认的管理员**  
**用户名     admin  
密码        admin**

进入数据库
    [root@zyy180 ~]# mysql -uadmin -padmin -h127.0.0.1 -P6032
    
    
    
    Welcome to the MariaDB monitor.  Commands end with ; or \g.
    Your MySQL connection id is 1
    Server version: 5.5.30 (ProxySQL Admin Module)
    
    Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
    
    Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
    
    MySQL [(none)]> 
    
    
    
    
    查看表内容
    MySQL [(none)]> show databases;
    +-----+---------------+-------------------------------------+
    | seq | name          | file                                |
    +-----+---------------+-------------------------------------+
    | 0   | main          |                                     |
    | 2   | disk          | /var/lib/proxysql/proxysql.db       |
    | 3   | stats         |                                     |
    | 4   | monitor       |                                     |
    | 5   | stats_history | /var/lib/proxysql/proxysql_stats.db |
    +-----+---------------+-------------------------------------+
    5 rows in set (0.00 sec)

# 5. 和admin管理接口相关的变量 #

### 5.1 admin-admin\_credentials ###

***admin-admin\_credentials 变量控制的是admin管理接口的管理员账户。***  
   
默认的管理员账户和密码为admin:admin，但是这个默认的用户只能在本地使用。如果想要远程连接到ProxySQL，例如用windows上的navicat连接Linux上的ProxySQL管理接口，必须自定义一个管理员账户。

1.添加管理员账户                                                      #账户之间要用 ; 隔开
    MySQL [(none)]> set admin-admin_credentials='admin:admin;zyy:zyy;';    ##如果不想要前面admin账户可以不加
    Query OK, 1 row affected (0.00 sec)
    
    
    
    
    2.使修改生效操作
    MySQL [(none)]> load admin variables to runtime;
    Query OK, 0 rows affected (0.00 sec)
    
    
    
    
    
    3.将修改永久保存到硬盘
    MySQL [(none)]> save admin variables to disk;
    Query OK, 35 rows affected (0.01 sec)
    
    
    
    
    
    
    查看，已经生效
    MySQL [(none)]> select @@admin-admin_credentials;
    +---------------------------+
    | @@admin-admin_credentials |
    +---------------------------+
    | admin:admin;zyy:zyy;      |
    +---------------------------+
    1 row in set (0.00 sec)

**使用另一台虚拟机尝试使用zyy用户登录**

[root@test ~]# mysql -uzyy -pzyy -h192.168.30.150 -P6032
    
    
    Welcome to the MariaDB monitor.  Commands end with ; or \g.
    Your MySQL connection id is 2
    Server version: 5.5.30 (ProxySQL Admin Module)
    
    Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
    
    Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
    
    MySQL [(none)]> 
    MySQL [(none)]>

**事实上所有的配置操作都是在修改main库中对应的表**

MySQL [(none)]> select * from main.global_variables where variable_name='admin-admin_credentials';
    +-------------------------+----------------------+
    | variable_name           | variable_value       |
    +-------------------------+----------------------+
    | admin-admin_credentials | admin:admin;zyy:zyy; |
    +-------------------------+----------------------+
    1 row in set (0.00 sec)

**必须要区分admin管理接口的用户名和mysql\_users中的用户名**

*  *admin管理接口的用户是连接到管理接口(默认端口6032)上用来管理、配置ProxySQL的*  
     
 *  *mysql\_users表中的用户名是应用程序连接ProxySQL(默认端口6033)，以及ProxySQL连接后端MySQL Servers使用的用户。它的作用是发送、路由SQL语句，类似于MySQL Server的3306端口。所以，这个表中的用户必须已经在后端MySQL Server上存在且授权了*

**admin管理接口的用户必须不能存在于mysql\_users中**，这是出于安全的考虑，防止通过admin管理接口用户猜出mysql\_users中的用户

### 5.2 admin-stats\_credentials ###

admin-stats\_credentials 变量控制admin管理接口的普通用户，这个变量中的用户没有超级管理员权限，**只能查看monitor库和main库中关于统计的数据**，其它库都是不可见的，且没有任何写权限

默认的普通用户名和密码均为 stats ，与admin一样，它默认也只能用于本地登录，若想让人远程查看则要添加查看的专有用户

查看
    MySQL [(none)]> select @@admin-stats_credentials;
    +---------------------------+
    | @@admin-stats_credentials |
    +---------------------------+
    | stats:stats               |
    +---------------------------+
    1 row in set (0.01 sec)
    
    
    
    1.增加普通用户
    MySQL [(none)]> set admin-stats_credentials='status:stats;user:user;';
    Query OK, 1 row affected (0.00 sec)
    
    
    
    
    
    2.将修改生效
    MySQL [(none)]> load admin variables to runtime;
    Query OK, 0 rows affected (0.00 sec)
    
    
    
    
    3.将修改长久生效
    MySQL [(none)]> save admin variables to disk;
    Query OK, 35 rows affected (0.00 sec)
    
    
    
    
    
    MySQL [(none)]> select @@admin-stats_credentials;
    +---------------------------+
    | @@admin-stats_credentials |
    +---------------------------+
    | status:stats;user:user;   |
    +---------------------------+
    1 row in set (0.00 sec)

**测试 使用user用户登录**

[root@test ~]# mysql -uuser -puser -h192.168.30.150 -P6032
    
    
    Welcome to the MariaDB monitor.  Commands end with ; or \g.
    Your MySQL connection id is 3
    Server version: 5.5.30 (ProxySQL Admin Module)
    
    Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
    
    Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
    
    MySQL [(none)]> 
    MySQL [(none)]> 
    
    
    
    
    只能查看main与monitor
    MySQL [(none)]> show databases;
    +-----+---------------+-------------------------------------+
    | seq | name          | file                                |
    +-----+---------------+-------------------------------------+
    | 0   | main          |                                     |
    | 2   | monitor       |                                     |
    | 3   | stats_history | /var/lib/proxysql/proxysql_stats.db |
    +-----+---------------+-------------------------------------+
    3 rows in set (0.00 sec)
    
    
    
    
    
    
    进入main表，查看
    可以发现是看不到runtime的表的
    
    MySQL [main]> show tables ;
    +--------------------------------------+
    | tables                               |
    +--------------------------------------+
    | global_variables                     |
    | stats_memory_metrics                 |
    | stats_mysql_commands_counters        |
    | stats_mysql_connection_pool          |
    | stats_mysql_connection_pool_reset    |
    | stats_mysql_errors                   |
    | stats_mysql_errors_reset             |
    | stats_mysql_free_connections         |
    | stats_mysql_global                   |
    | stats_mysql_gtid_executed            |
    | stats_mysql_prepared_statements_info |
    | stats_mysql_processlist              |
    | stats_mysql_query_digest             |
    | stats_mysql_query_digest_reset       |
    | stats_mysql_query_rules              |
    | stats_mysql_users                    |
    | stats_proxysql_servers_checksums     |
    | stats_proxysql_servers_metrics       |
    | stats_proxysql_servers_status        |
    +--------------------------------------+
    19 rows in set (0.01 sec)

### 5.3 admin-mysql\_ifaces ###

admin-mysql\_ifaces 变量**指定admin接口的监听地址**，格式为冒号分隔的hostname:port列表。默认监听在 0.0.0.0:6032

注意，允许使用UNIX的domain socket进行监听，这样本主机内的应用程序就可以直接被处理。

MySQL [(none)]> select @@admin-mysql_ifaces;
    +----------------------+
    | @@admin-mysql_ifaces |
    +----------------------+
    | 0.0.0.0:6032         |
    +----------------------+
    1 row in set (0.00 sec)
    
    
    
    1.修改端口
    MySQL [(none)]> set admin-mysql_ifaces='0.0.0.0:8888' ;
    Query OK, 1 row affected (0.00 sec)
    
    
    
    
    2.使修改生效
    MySQL [(none)]> load admin variables to runtime;
    Query OK, 0 rows affected (0.00 sec)
    
    
    
    
    3.将修改保存
    MySQL [(none)]> save admin variables to disk;
    Query OK, 35 rows affected (0.00 sec)
    
    
    
    
    MySQL [(none)]> select @@admin-mysql_ifaces;
    +----------------------+
    | @@admin-mysql_ifaces |
    +----------------------+
    | 0.0.0.0:8888         |
    +----------------------+
    1 row in set (0.00 sec)
    
    
    
    
    
    端口发生改变
    [root@zyy180 ~]# ss -anlt
    State       Recv-Q Send-Q Local Address:Port               Peer Address:Port              
    LISTEN      0      128              *:6033                         *:*                  
    LISTEN      0      128              *:6033                         *:*                  
    LISTEN      0      128              *:6033                         *:*                  
    LISTEN      0      128              *:6033                         *:*                  
    LISTEN      0      128              *:22                           *:*                  
    LISTEN      0      128              *:8888                         *:*                  
    LISTEN      0      100      127.0.0.1:25                           *:*                  
    LISTEN      0      128             :::22                          :::*                  
    LISTEN      0      100            ::1:25                          :::*

**测试 使用8888端口登录**

[root@test ~]# mysql -uzyy -pzyy -h192.168.30.150 -P8888;
    
    
    Welcome to the MariaDB monitor.  Commands end with ; or \g.
    Your MySQL connection id is 4
    Server version: 5.5.30 (ProxySQL Admin Module)
    
    Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
    
    Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
    
    MySQL [(none)]>

# 6. 多层配置系统 #

### 6.1 proxysql的库 ###

**其中：**

*  **main库是ProxySQL最主要的库，是需要修改配置时使用的库，它其实是一个内存数据库系统。所以，修改main库中的配置后，必须将其持久化到disk上才能永久保存**  
     
 *  **disk库是磁盘数据库，该数据库结构和内存数据库完全一致。当持久化内存数据库中的配置时，其实就是写入到disk库中。磁盘数据库的默认路径为 $DATADIR/proxysql.db**  
     
 *  **stats库是统计信息库。这个库中的数据一般是在检索其内数据时临时填充的，它保存在内存中。因为没有相关的配置项，所以无需持久化**  
     
 *  **monitor库是监控后端MySQL节点相关的库，该库中只有几个log类的表，监控模块收集到的监控信息全都存放到对应的log表中**  
     
 *  **stats\_history库是1.4.4版新增的库，用于存放历史统计数据。默认路径为 $DATADIR/proxysql\_stats.db**

*ProxySQL 内部使用的是 SQLite3 数据库，无论是内存数据库还是磁盘数据库，都是通过SQLite3引 擎进行解析、操作的。它和 MySQL 的语法可能稍有不同，但ProxySQL会对不兼容的语法自动进行调整，最大程度上保证MySQL语句的有效率。*  
   
*上面描述main库的时候，只是说了内存数据库需要持久化到disk库才能永久保存配置。但实际上，修改了main库中的配置后，并不会立即生效，它还需要load到runtime的数据结构中才生效，只有在runtime数据结构中的配置才是对ProxySQL当前有效的配置*

### 6.2 ProxySQL多层配置系统 ###

+-------------------------+
           |         RUNTIME         |
           +-------------------------+
                  /|\          |
                   |           |
               [1] |       [2] |
                   |          \|/
           +-------------------------+
           |         MEMORY          |
           +-------------------------+ _
                  /|\          |      |\
                   |           |        \
               [3] |       [4] |         \ [5]
                   |          \|/         \
           +-------------------------+ +---------------+
           |          DISK           |  |  CONFIG FILE  |
           +-------------------------+ +---------------+

*最底层的是 disk 库和 config file 。这里需要注意，这里的 config file 就是传统的配置文件，默认为 /etc/proxysql.cnf ， **ProxySQL 启动时，主要是从 disk 库中读取配置加载到内存并最终加载到 runtime 生效**，只有极少的几个特定配置内容是从 config file 中加载的，除非是第一次初始化 ProxySQL 运行环境(或者disk库为空)。*

*中间层的是 memory ，**表示的是内存数据库，其实就是 main 库**。通过管理接口修改的所有配置，都保存在内存数据库(main)中。当 ProxySQL 重启或者崩溃时，这个内存数据库中的数据会丢失，所以需要 save 到 disk 库中。*

*最上层的是 runtime ，它是 ProxySQL 有关线程运行时读取的数据结构。换句话说，**该数据结构中的配置都是已生效的配置。所以，修改了 main 库中的配置后，必须 load 到 runtime 数据结构中才能使其生效**。*  
   
   
在上面的多层配置系统图中，标注了\[1\]、\[2\]、\[3\]、\[4\]、\[5\]的序号。每个序号都有两个操作方向from/to，其实只是所站角度不同而已。以下是各序号对应的操作：

[1] ：将内存数据库中的配置加载到RUNTIME数据结构中
            LOAD XXX FROM MEMORY
            LOAD XXX TO RUNTIME
    
    
    [2] ：将RUNTIME数据结构中的配置持久化到内存数据库中
            SAVE XXX FROM RUNTIME
            SAVE XXX TO MEMORY
    
    
    [3] ：将磁盘数据库中的配置加载到内存数据库中
            LOAD XXX FROM DISK
            LOAD XXX TO MEMORY
    
    
    [4] ：将内存数据库中的配置持久化到磁盘数据库中
            SAVE XXX FROM MEMORY
            SAVE XXX TO DISK
    
    
    [5] ：从传统配置文件中读取配置加载到内存数据库中
            LOAD XXX FROM CONFIG
    
    
    
    
    我们最常用的  ：
    LOAD  XXX   TO   TUNTIME;   //加载到内存，使其生效
    SAVE  XXX   TO    DISK;     //存放到硬盘，使其长期生效

*DISK/MEMORY/RUNTIME/CONFIG 可以缩写，只要能识别即可。例如MEMORY可以缩写为MEM，runtime可以缩写为run*

**另外，上面的XXX表示要加载/保存的是哪类配置。目前的ProxySQL支持以下几种：**

*  **mysql users**
 *  **mysql servers**
 *  **mysql variables**
 *  **mysql query rules**
 *  **admin variables**
 *  **scheduler**
 *  *proxysql\_servers：目前ProxySQL集群功能还处于实验阶段，所以该类配置不应该去使用。*

### 6.3 proxysql各张表的含义 ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3p5eTEzMDk4OA_size_16_color_FFFFFF_t_70_pic_center 1]

**mysql\_servers：包含用于连接到ProxySQL的后端服务器列表**  
   
**mysql\_users：包含用于向ProxySQL和后端服务器进行身份验证的用户列表**  
   
**mysql\_query\_rules：包含缓存，路由或重写通过代理的SQL查询的规则**  
   
global\_variables：包含单个表中的MySQL变量和管理变量  
   
debug\_levels：仅用于ProxySQL的调试版本

### 6.4 proxysql核心表 ###

##### mysql\_servers #####

MySQL [(none)]> select * from mysql_servers;
    +--------------+----------------+------+-----------+--------+--------+-------------+-----------------+---------------------+---------+----------------+-------------+
    | hostgroup_id | hostname       | port | gtid_port | status | weight | compression | max_connections | max_replication_lag | use_ssl | max_latency_ms | comment     |
    +--------------+----------------+------+-----------+--------+--------+-------------+-----------------+---------------------+---------+----------------+-------------+
    | 10           | 192.168.30.245 | 3306 | 0         | ONLINE | 1      | 0           | 1000            | 0                   | 0       | 0              | Write Group |
    | 20           | 192.168.30.246 | 3306 | 0         | ONLINE | 1      | 0           | 1000            | 0                   | 0       | 0              | Read Group  |
    +--------------+----------------+------+-----------+--------+--------+-------------+-----------------+---------------------+---------+----------------+-------------+
    2 rows in set (0.00 sec)

<table> 
 <thead> 
  <tr> 
   <th>字段</th> 
   <th>含义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>hostgroup_id</td> 
   <td>自增id,后端服务器所属的主机组的id</td> 
  </tr> 
  <tr> 
   <td>hostname</td> 
   <td>数据库ip</td> 
  </tr> 
  <tr> 
   <td>prot</td> 
   <td>数据端口</td> 
  </tr> 
  <tr> 
   <td>status</td> 
   <td>状态说明，默认ONLINE</td> 
  </tr> 
  <tr> 
   <td>weight</td> 
   <td>权重，默认值1</td> 
  </tr> 
  <tr> 
   <td>max_connections</td> 
   <td>最大连接数</td> 
  </tr> 
  <tr> 
   <td>max_replication_lag</td> 
   <td>检查主从延迟（0:默认不检查）</td> 
  </tr> 
  <tr> 
   <td>comment</td> 
   <td>注释说明</td> 
  </tr> 
 </tbody> 
</table>

**常用的**

MySQL [(none)]> select hostgroup_id,hostname,port,weight,comment from mysql_servers;
    +--------------+----------------+------+--------+-------------+
    | hostgroup_id | hostname       | port | weight | comment     |
    +--------------+----------------+------+--------+-------------+
    | 10           | 192.168.30.245 | 3306 | 1      | Write Group |
    | 20           | 192.168.30.246 | 3306 | 1      | Read Group  |
    +--------------+----------------+------+--------+-------------+
    2 rows in set (0.00 sec)

##### mysql\_users #####

<table> 
 <thead> 
  <tr> 
   <th>字段</th> 
   <th>含义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>username</td> 
   <td>用户名</td> 
  </tr> 
  <tr> 
   <td>password</td> 
   <td>密码（明文或者密文）</td> 
  </tr> 
  <tr> 
   <td>active</td> 
   <td>是否启用</td> 
  </tr> 
  <tr> 
   <td>use_ssl</td> 
   <td>是否使用SSL连接</td> 
  </tr> 
  <tr> 
   <td>default_hostgroup</td> 
   <td>默认查询的数据库(没有匹配到规则，就使用这个库)</td> 
  </tr> 
  <tr> 
   <td>default_schema</td> 
   <td>默认数据库</td> 
  </tr> 
  <tr> 
   <td>schema_locked</td> 
   <td>限定用户在默认数据库中</td> 
  </tr> 
  <tr> 
   <td>transaction_persistent</td> 
   <td>事务路由分配持久性，同一个事务的语句不会被分配到不同的组</td> 
  </tr> 
  <tr> 
   <td>fast_forward</td> 
   <td>快速回收空闲线程</td> 
  </tr> 
  <tr> 
   <td>backend</td> 
   <td>是否为后端数据库的账户</td> 
  </tr> 
  <tr> 
   <td>frontend</td> 
   <td>是否为ProxySQL本身的账户（通过6033端口接入ProxySQL）</td> 
  </tr> 
  <tr> 
   <td>max_connections</td> 
   <td>该用户对ProxysSQL最大连接数</td> 
  </tr> 
  <tr> 
   <td>comment</td> 
   <td>备注</td> 
  </tr> 
 </tbody> 
</table>

**常用字段**

##### mysql\_query\_rules #####

rule_id:              自增id,规则id；
    active:               是否启用sql路由项，1：启用；0：不启用（默认）
    username:             如果非空，只有连接用户名是username的值才会匹配
    schemaname:           如果非空，只有查询连接使用的db是schemaname的值才会匹配，默认是information_schema
    flagIN:
    client_addr:          匹配客户端ip
    proxy_addr:           匹配本地proxysql的ip
    proxy_port:           匹配本地proxysql的port
    digest:               精确匹配的一类查询
    match_digest:         正则匹配一类查询
    match_pattern:        正则表达式匹配查询
    negate_match_pattern: 反向匹配，相当与match_digest/
    flogOUT
    replace_pattern:      查询重写，默认为空
    destination_hostgroup:路由查询指向的hostgroup
    cache_ttl:            查询结果缓存的毫秒数
    timeout:              查询执行的最大时间ms,超时则自动kill,默认10h
    retries:              执行失败时，重试次数，默认1
    delay:                查询延时执行
    error_msg:            返回的指定的错误信息
    OK_msg:               连接成功返回的信息
    multiplex:            连接是否复用
    log:                  是否记录查询日志
    apply:                是否启用
    comment:              注释

**常用字段**

MySQL [(none)]> select rule_id,active,match_digest,destination_hostgroup,apply from mysql_query_rules;
    +---------+--------+----------------------+-----------------------+-------+
    | rule_id | active | match_digest         | destination_hostgroup | apply |
    +---------+--------+----------------------+-----------------------+-------+
    | 1       | 1      | ^SELECT.*FOR UPDATE$ | 10                    | 1     |
    | 2       | 1      | ^SHOW                | 20                    | 1     |
    | 20      | 1      | ^SELECT              | 20                    | 1     |
    +---------+--------+----------------------+-----------------------+-------+
    3 rows in set (0.00 sec)

### 6.5 启动ProxySQL时如何加载配置 ###

如果 ProxySQL 是刚安装的，或者磁盘数据库文件为空(甚至不存在)，或者启动 ProxySQL 时使用了选项 --initial，这几种情况启动 ProxySQL 时，都会从传统配置文件 config file 中读取配置加载到内存数据库，并自动 load 到 runtime 数据结构、save到磁盘数据库，这是初始化 ProxySQL 运行环境的过程。  
   
如果不是第一次启动 ProxySQL ，由于已经存在磁盘数据库文件，这时 ProxySQL 会从磁盘数据库中读取几乎所有的配置(即使传统配置文件中配置了某项，也不会去解析)，但有3项是必须从传统配置文件中读取，它们分别是：

*  datadir：ProxySQL启动时，必须从配置文件中确定它的数据目录，因为磁盘数据库文件、日志以及其它一些文件是存放在数据目录下的。如果使用/etc/init.d/proxysql管理ProxySQL，则除了修改/etc/proxysql.cnf的datadir，还需要修改该脚本中的datadir。  
     
 *  restart\_on\_missing\_heartbeats：MySQL线程丢失多少次心跳，就会杀掉这个线程并重启它。默认值为10。  
    execute\_on\_exit\_failure：如果设置了该变量，ProxySQL父进程将在每次ProxySQL崩溃的时候执行已经定义好的脚本。建议使用它来生成一些崩溃时的警告和日志。注意，ProxySQL的重启速度可能只有几毫秒，因此很多其它的监控工具可能无法探测到ProxySQL的一次普通故障，此时可使用该变量

# 7. 不同类型的读写分离方案解析 #

数据库中间件最基本的功能就是实现读写分离， ProxySQL 当然也支持。而且 ProxySQL 支持的路由规则非常灵活，不仅可以实现最简单的读写分离，还可以将读/写都分散到多个不同的组，以及实现分库 sharding (分表sharding的规则比较难写，但也能实现)。

本文只描述通过规则制定的语句级读写分离，不讨论通过 ip/port, client, username, schemaname 实现的读写分离。

下面描述了ProxySQL能实现的常见读写分离类型

### 7.1 最简单的读写分离架构 ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3p5eTEzMDk4OA_size_16_color_FFFFFF_t_70_pic_center 2]  
这种模式的读写分离，严格区分后端的master和slave节点，且slave节点必须设置选项read\_only=1

在ProxySQL上，分两个组，一个写组HG=10，一个读组HG=20。同时在ProxySQL上开启monitor模块的read\_only监控功能，让ProxySQL根据监控到的read\_only值来自动调整节点放在HG=10(master会放进这个组)还是HG=20(slave会放进这个组)

这种模式的读写分离是最简单的，只需在mysql\_users表中设置用户的默认路由组为写组HG=10，并在mysql\_query\_rules中加上两条简单的规则(一个select for update，一个select)即可

这种读写分离模式，在环境较小时能满足绝大多数需求。但是需求复杂、环境较大时，这种模式就太过死板，因为一切都是monitor模块控制的

### 7.2 多个读组或写组的分离模式 ###

前面那种读写分离模式，是通过 monitor 模块监控 read\_only 来调整的，所以每一个后端集群必须只能分为一个写组，一个读组。  
但如果想要区分不同的 select ，并将不同的 select 路由到不同的节点上。例如有些查询语句的开销非常大，想让它们独占一个节点/组，其它查询共享一个节点/组，怎么实现？

例如，下面这种模式  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3p5eTEzMDk4OA_size_16_color_FFFFFF_t_70_pic_center 3]  
**看上去非常简单。但是却能适应各种需求。例如，后端做了分库，对某库的查询要路由到特定的主机组**

至于各个主机组是同一个主从集群(下图左边)，还是互相独立的主从集群环境(下图右边)，要看具体的需求，不过这种读写分离模式都能应付

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3p5eTEzMDk4OA_size_16_color_FFFFFF_t_70_pic_center 4]  
在实现这种模式时，前提是不能开启monitor模块的read\_only监控功能，也不要设置mysql\_replication\_hostgroup 表

例如，下面的配置实现的是上图左边的结构：写请求路由给HG=10，对test1库的select语句路由给HG=20，其它select路由给HG=30

mysql_servers: 
    +--------------+----------+------+--------+--------+
    | hostgroup_id | hostname | port | status | weight |
    +--------------+----------+------+--------+--------+
    | 10           | host1    | 3306 | ONLINE | 1      |
    | 20           | host2    | 3306 | ONLINE | 1      |
    | 30           | host3    | 3306 | ONLINE | 1      |
    +--------------+----------+------+--------+--------+
    
    mysql_users: 
    +----------+-------------------+
    | username | default_hostgroup |
    +----------+-------------------+
    | root     | 10                |
    +----------+-------------------+
    
    mysql_query_rules: 
    +---------+-----------------------+----------------------+
    | rule_id | destination_hostgroup | match_digest         |
    +---------+-----------------------+----------------------+
    | 1       | 10                    | ^SELECT.*FOR UPDATE$ |
    | 2       | 20                    | ^SELECT.*test1\..*   |
    | 3       | 30                    | ^SELECT              |
    +---------+-----------------------+----------------------+

**查看表结构的方式：**

PRAGMA  table_info("表名");

# 8. 使用proxysql实现读写分离 #

**master和slave两台主机需要做mysql主从**  
[mysql主从][mysql]

<table> 
 <thead> 
  <tr> 
   <th>主机</th> 
   <th>IP</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>proxysql</td> 
   <td>192.168.30.150/24</td> 
  </tr> 
  <tr> 
   <td>master</td> 
   <td>192.168.30.245/24</td> 
  </tr> 
  <tr> 
   <td>slave</td> 
   <td>192.168.30.246/24</td> 
  </tr> 
 </tbody> 
</table>

[root@proxysql ~]# export MYSQL_PS1="(\u@\h:\p) [\d]> "
    
    
    [root@proxysql ~]# mysql -uadmin -padmin -h127.0.0.1 -P6032
    Welcome to the MariaDB monitor.  Commands end with ; or \g.
    Your MySQL connection id is 1
    Server version: 5.5.30 (ProxySQL Admin Module)
    
    Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
    
    Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
    
    (admin@127.0.0.1:6032) [(none)]>

### 添加主机到 mysql\_servers 表中 ###

[(none)]> insert into mysql_servers(hostgroup_id,hostname,port,weight,comment) values(10,'192.168.30.245',3306,1,'Write Group');
    Query OK, 1 row affected (0.00 sec)
    
    
    
    
    [(none)]> insert into mysql_servers(hostgroup_id,hostname,port,weight,comment) values(20,'192.168.30.246',3306,1,'Read Group');
    Query OK, 1 row affected (0.00 sec)
    
    
    
    
    
    [(none)]> select hostgroup_id,hostname,port,weight,comment  from mysql_servers;
    +--------------+----------------+------+--------+-------------+
    | hostgroup_id | hostname       | port | weight | comment     |
    +--------------+----------------+------+--------+-------------+
    | 10           | 192.168.30.245 | 3306 | 1      | Write Group |
    | 20           | 192.168.30.246 | 3306 | 1      | Read Group  |
    +--------------+----------------+------+--------+-------------+
    2 rows in set (0.00 sec)
    
    
    
    
    
    修改后添加到内存
    [(none)]> load mysql servers  to runtime;
    Query OK, 0 rows affected (0.00 sec)
    
    
    
    
    
    修改后添加到硬盘
    [(none)]> save mysql servers to disk;
    Query OK, 0 rows affected (0.03 sec)

**mysql主库添加proxysql可以增删改查的账号**

MariaDB [(none)]> grant all on *.* to 'proxysql'@'192.168.30.150' identified by 'pwproxysql';
    Query OK, 0 rows affected (0.00 sec)
    
    
    
    
    MariaDB [(none)]> flush privileges;
    Query OK, 0 rows affected (0.00 sec)

### 添加增删改查的账号到mysql\_users ###

在 proxysql 主机的 mysql\_users 表中添加刚才在 master 上创建的账号 proxysqlproxysql 客户端需要使用这个账号来访问数据库

default\_hostgroup 默认组设置为写组，也就是10;

当读写分离的路由规则不符合时，会访问默认组的数据库;

[(none)]> insert into mysql_users(username,password,default_hostgroup,transaction_persistent)values('proxysql','pwproxysql',10,1);
    Query OK, 1 row affected (0.00 sec)
    
    
    
    [(none)]> select * from mysql_users\G;
    *************************** 1. row ***************************
                  username: proxysql
                  password: pwproxysql
                    active: 1
                   use_ssl: 0
         default_hostgroup: 10
            default_schema: NULL
             schema_locked: 0
    transaction_persistent: 1
              fast_forward: 0
                   backend: 1
                  frontend: 1
           max_connections: 10000
                   comment: 
    1 row in set (0.00 sec)
    
    
    
    
    
    [(none)]> load mysql users to runtime;
    Query OK, 0 rows affected (0.00 sec)
    
    
    
    
    [(none)]> save mysql users to disk;
    Query OK, 0 rows affected (0.00 sec)

### 添加健康检测的帐号 ###

**在主mysql 端创建一个属于proxysql的只读账号**

MariaDB [(none)]> grant select on  *.* to 'monitor'@'192.168.30.%' identified by 'monitor';Query OK, 0 rows affected (0.00 sec)
    
    
    
    
    MariaDB [(none)]> flush privileges;
    Query OK, 0 rows affected (0.00 sec)

**在proxysql主机端修改变量设置健康检测的账号**

[(none)]> set mysql-monitor_username='monitor';
    Query OK, 1 row affected (0.00 sec)
    
    
    
    [(none)]> set mysql-monitor_password='monitor';
    Query OK, 1 row affected (0.00 sec)
    
    
    
    [(none)]> load mysql variables to runtime;
    Query OK, 0 rows affected (0.00 sec)
    
    
    
    [(none)]> save mysql variables to disk;
    Query OK, 134 rows affected (0.00 sec)

### 添加读写分离的路由规则到mysql\_query\_rules ###

[(none)]> insert into mysql_query_rules(rule_id,active,match_digest,destination_hostgroup,apply)values(1,1,'^SELECT.*FOR UPDATE$',10,1);
    Query OK, 1 row affected (0.00 sec)
    
    
    
    
    [(none)]> insert into mysql_query_rules(rule_id,active,match_digest,destination_hostgroup,apply)values(20,1,'^SELECT',20,1);
    Query OK, 1 row affected (0.00 sec)
    
    
    
    
    
    [(none)]> load mysql query rules to runtime;
    Query OK, 0 rows affected (0.00 sec)
    
    
    
    
    [(none)]> save mysql query rules to disk;
    Query OK, 0 rows affected (0.00 sec)
    
    
    
    
    
    MySQL [(none)]> select rule_id,active,match_digest,destination_hostgroup,apply from mysql_query_rules;
    +---------+--------+----------------------+-----------------------+-------+
    | rule_id | active | match_digest         | destination_hostgroup | apply |
    +---------+--------+----------------------+-----------------------+-------+
    | 1       | 1      | ^SELECT.*FOR UPDATE$ | 10                    | 1     |
    | 20      | 1      | ^SELECT              | 20                    | 1     |
    +---------+--------+----------------------+-----------------------+-------+
    3 rows in set (0.00 sec)

## 验证mysql读写分离 ##

**登录proxysql账号，开始验证**

[root@proxysql ~]# mysql -uproxysql -ppwproxysql -h127.0.0.1 -P6033
    
    Welcome to the MariaDB monitor.  Commands end with ; or \g.
    Your MySQL connection id is 2
    Server version: 5.5.30 (ProxySQL)
    
    Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
    
    Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
    MySQL [(none)]>

**创建一个库，查看表**

### 验证读写分离是否成功 ###

[(none)]> select * from stats_mysql_query_digest\G;
    
    
    *************************** 1. row ***************************
            hostgroup: 20
           schemaname: information_schema
             username: proxysql
       client_address: 
               digest: 0x0F02B330C823D739
          digest_text: select user,host from mysql.user
           count_star: 1
           first_seen: 1597412556
            last_seen: 1597412556
             sum_time: 3473
             min_time: 3473
             max_time: 3473
    sum_rows_affected: 0
        sum_rows_sent: 8
    *************************** 2. row ***************************
            hostgroup: 10
           schemaname: information_schema
             username: proxysql
       client_address: 
               digest: 0x8EDE17037DA6D17A
          digest_text: create database zyyyyyy
           count_star: 1
           first_seen: 1597412531
            last_seen: 1597412531
             sum_time: 2837
             min_time: 2837
             max_time: 2837
    sum_rows_affected: 1
        sum_rows_sent: 0
    *************************** 3. row ***************************
            hostgroup: 10
           schemaname: information_schema
             username: proxysql
       client_address: 
               digest: 0x226CD90D52A2BA0B
          digest_text: select @@version_comment limit ?
           count_star: 1
           first_seen: 1597412470
            last_seen: 1597412470
             sum_time: 0
             min_time: 0
             max_time: 0
    sum_rows_affected: 0
        sum_rows_sent: 0
    3 rows in set (0.00 sec)
    
    ERROR: No query specified

**添加策略**  
可以看到show database 是查看命令却是默认组(写组10)在执行

[(none)]> select * from stats_mysql_query_digest\G;
    *************************** 1. row ***************************
            hostgroup: 10
           schemaname: information_schema
             username: proxysql
       client_address: 
               digest: 0x02033E45904D3DF0
          digest_text: show databases
           count_star: 1
           first_seen: 1597412676
            last_seen: 1597412676
             sum_time: 1300
             min_time: 1300
             max_time: 1300
    sum_rows_affected: 0
        sum_rows_sent: 6

**添加策略**

[(none)]> insert into mysql_query_rules(rule_id,active,match_digest,destination_hostgroup,apply)values(2,1,'^SHOW',20,1);
    Query OK, 1 row affected (0.00 sec)
    
    
    
    [(none)]> load mysql query rules to runtime;
    Query OK, 0 rows affected (0.00 sec)
    
    
    
    
    [(none)]> save mysql query rules to disk;
    Query OK, 0 rows affected (0.01 sec)
    
    
    
    
    [(none)]> select rule_id,active,match_digest,destination_hostgroup,apply from mysql_query_rules;
    +---------+--------+----------------------+-----------------------+-------+
    | rule_id | active | match_digest         | destination_hostgroup | apply |
    +---------+--------+----------------------+-----------------------+-------+
    | 1       | 1      | ^SELECT.*FOR UPDATE$ | 10                    | 1     |
    | 2       | 1      | ^SHOW                | 20                    | 1     |
    | 20      | 1      | ^SELECT              | 20                    | 1     |
    +---------+--------+----------------------+-----------------------+-------+
    3 rows in set (0.00 sec)

**再次验证**

[(none)]> select * from stats_mysql_query_digest\G
            hostgroup: 20
           schemaname: information_schema
             username: proxysql
       client_address: 
               digest: 0x02033E45904D3DF0
          digest_text: show databases
           count_star: 1
           first_seen: 1597413184
            last_seen: 1597413184
             sum_time: 2357
             min_time: 2357
             max_time: 2357
    sum_rows_affected: 0
        sum_rows_sent: 6

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3p5eTEzMDk4OA_size_16_color_FFFFFF_t_70_pic_center]: /images/20221124/fd6c10aed3624d76a64cb9a5e6dff8b1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3p5eTEzMDk4OA_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221124/e2ac51b63840479380ad25d588956356.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3p5eTEzMDk4OA_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221124/580abecb11b945aa9ff68dd799334b75.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3p5eTEzMDk4OA_size_16_color_FFFFFF_t_70_pic_center 3]: /images/20221124/1869d44d6fe3475789eacb870d1b249b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3p5eTEzMDk4OA_size_16_color_FFFFFF_t_70_pic_center 4]: /images/20221124/991ca9c0afec4e219e68c8337f846841.png
[mysql]: https://blog.csdn.net/zyy130988/article/details/106854410