【实践分享】ProxySQL 实现 Doris FE 高可用

1 文章简介

ProxySQL 是灵活强大的 MySQL 代理层, 是一个能实实在在用在生产环境的 MySQL 中间件，可以实现读写分离，支持 Query 路由功能，支持动态指定某个 SQL 进行 cache，支持动态加载配置、故障切换和一些 SQL 的过滤功能。

Doris 的 FE 进程负责接收用户连接和查询请求，其本身是可以横向扩展且高可用的，但是需要用户在多个 FE 上架设一层 proxy，来实现自动的连接负载均衡。

本文主要介绍 ProxySQL 的安装和使用，以及如何搭配 Doris 实现 FE 的负载均衡。

2 ProxySQL 安装（yum）

[root@mysql-proxy ~]# vim /etc/yum.repos.d/proxysql.repo[proxysql_repo]name= ProxySQL YUM repositorybaseurl=http://repo.proxysql.com/ProxySQL/proxysql-1.4.x/centos/\$releasevergpgcheck=1gpgkey=http://repo.proxysql.com/ProxySQL/repo_pub_key执行安装[root@mysql-proxy ~]# yum clean all[root@mysql-proxy ~]# yum makecache[root@mysql-proxy ~]# yum -y install proxysql [root@mysql-proxy ~]# proxysql --versionProxySQL version 1.4.13-15-g69d4207, codename Truls设置开机自启动[root@mysql-proxy ~]# systemctl enable proxysql[root@mysql-proxy ~]# systemctl start proxysql      [root@mysql-proxy ~]# systemctl status proxysql启动后会监听两个端口，默认为6032和6033。6032端口是ProxySQL的管理端口，6033是ProxySQL对外提供服务的端口 (即连接到转发后端的真正数据库的转发端口)。[root@mysql-proxy ~]# netstat -tunlpActive Internet connections (only servers)Proto Recv-Q Send-Q Local Address           Foreign Address         State       PID/Program name  tcp        0      0 0.0.0.0:6032            0.0.0.0:*               LISTEN      23940/proxysql    tcp        0      0 0.0.0.0:6033            0.0.0.0:*               LISTEN

3 ProxySQL 配置

ProxySQL 有配置文件 /etc/proxysql.cnf 和配置数据库文件 /var/lib/proxysql/proxysql.db。

这里需要特别注意：如果存在 "proxysql.db" 文件(在/var/lib/proxysql 目录下)，则 ProxySQL 服务只有在第一次启动时才会去读取 proxysql.cnf 文件并解析；后面启动会就不会读取 proxysql.cnf 文件了！如果想要让 proxysql.cnf 文件里的配置在重启 ProxySQL 服务后生效(即想要让 ProxySQL 重启时读取并解析 proxysql.cnf 配置文件)，则需要先删除 /var/lib/proxysql/proxysql.db 数据库文件，然后再重启 ProxySQL 服务。这样就相当于初始化启动 ProxySQL 服务了，会再次生产一个纯净的 proxysql.db 数据库文件(如果之前配置了 ProxySQL 相关路由规则等，则就会被抹掉)。

[root@mysql-proxy ~]# egrep -v "^#|^$" /etc/proxysql.cnfdatadir="/var/lib/proxysql"                                   #数据目录admin_variables={       admin_credentials="admin:admin"  #连接管理端的用户名与密码       mysql_ifaces="0.0.0.0:6032"    #管理端口，用来连接proxysql的管理数据库}mysql_variables={       threads=4                                             #指定转发端口开启的线程数量       max_connections=2048       default_query_delay=0       default_query_timeout=36000000       have_compress=true       poll_timeout=2000       interfaces="0.0.0.0:6033"       #指定转发端口，用于连接后端mysql数据库的，相当于代理作用       default_schema="information_schema"       stacksize=1048576       server_version="5.5.30"                               #指定后端mysql的版本       connect_timeout_server=3000       monitor_username="monitor"       monitor_password="monitor"       monitor_history=600000       monitor_connect_interval=60000       monitor_ping_interval=10000       monitor_read_only_interval=1500       monitor_read_only_timeout=500       ping_interval_server_msec=120000       ping_timeout_server=500       commands_stats=true       sessions_sort=true       connect_retries_on_failure=10}mysql_servers =()mysql_users:()mysql_query_rules:()scheduler=()mysql_replication_hostgroups=()连接ProxySQL管理端口[root@mysql-proxy ~]# mysql -uadmin -padmin -P6032 -hdoris01查看main库（默认登陆后即在此库）的global_variables表信息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.000 sec)MySQL [(none)]> use main;Reading table information for completion of table and column namesYou can turn off this feature to get a quicker startup with -ADatabase changedMySQL [main]> show tables;+--------------------------------------------+| tables                                     |+--------------------------------------------+| global_variables                           || mysql_collations                           || mysql_group_replication_hostgroups         || mysql_query_rules                         || mysql_query_rules_fast_routing             || mysql_replication_hostgroups               || mysql_servers                             || mysql_users                               || proxysql_servers                           || runtime_checksums_values                   || runtime_global_variables                   || runtime_mysql_group_replication_hostgroups || runtime_mysql_query_rules                 || runtime_mysql_query_rules_fast_routing     || runtime_mysql_replication_hostgroups       || runtime_mysql_servers                     || runtime_mysql_users                       || runtime_proxysql_servers                   || runtime_scheduler                         || scheduler                                 |+--------------------------------------------+20 rows in set (0.000 sec)这些表的含义及作用大家可以在网上搜索

4 ProxySQL 配置后端 Doris FE

使用insert语句添加主机到mysql_servers表中，其中：hostgroup_id 为10表示写组，为20表示读组，我们这里不需要读写分许，无所谓随便设置哪一个都可以，后面我会讲出现的问题及解决办法。 [root@mysql-proxy ~]# mysql -uadmin -padmin -P6032 -h127.0.0.1............MySQL [(none)]> insert into mysql_servers(hostgroup_id,hostname,port) values(10,'192.168.9.211',9030);Query OK, 1 row affected (0.000 sec) MySQL [(none)]> insert into mysql_servers(hostgroup_id,hostname,port) values(10,'192.168.9.212',9030);Query OK, 1 row affected (0.000 sec) MySQL [(none)]> insert into mysql_servers(hostgroup_id,hostname,port) values(10,'192.168.9.213',9030);Query OK, 1 row affected (0.000 sec)如果在插入过程中，出现报错：ERROR 1045 (#2800): UNIQUE constraint failed: mysql_servers.hostgroup_id, mysql_servers.hostname, mysql_servers.port说明可能之前就已经定义了其他配置，可以清空这张表 或者 删除对应host的配置MySQL [(none)]> select * from mysql_servers;MySQL [(none)]> delete from mysql_servers;Query OK, 6 rows affected (0.000 sec)查看这3个节点是否插入成功，以及它们的状态。MySQL [(none)]> select * from mysql_servers\G;*************************** 1. row ***************************      hostgroup_id: 10          hostname: 192.168.9.211              port: 9030            status: ONLINE            weight: 1      compression: 0  max_connections: 1000max_replication_lag: 0          use_ssl: 0    max_latency_ms: 0          comment:*************************** 2. row ***************************      hostgroup_id: 10          hostname: 192.168.9.212              port: 9030            status: ONLINE            weight: 1      compression: 0  max_connections: 1000max_replication_lag: 0          use_ssl: 0    max_latency_ms: 0          comment:*************************** 3. row ***************************      hostgroup_id: 10          hostname: 192.168.9.213              port: 9030            status: ONLINE            weight: 1      compression: 0  max_connections: 1000max_replication_lag: 0          use_ssl: 0    max_latency_ms: 0          comment:6 rows in set (0.000 sec) ERROR: No query specified 如上修改后，加载到RUNTIME，并保存到diskMySQL [(none)]> load mysql servers to runtime;Query OK, 0 rows affected (0.006 sec) MySQL [(none)]> save mysql servers to disk;Query OK, 0 rows affected (0.348 sec)

5 监控后端 Doirs 节点

添 Doris FE 节点之后，还需要监控这些后端节点。对于后端多个 FE 高可用负载均衡环境来说，这是必须的，因为 ProxySQL 需要通过每个节点的 read_only 值来自动调整。它们是属于读组还是写组。

首先在后端 Master 主数据节点上创建一个用于监控的用户名。

在doris fe master主数据库节点行执行：[root@doris01 ~]# mysql -P9030 -uroot -pmysql> create user monitor@'192.168.9.%' identified by 'P@ssword1!';Query OK, 0 rows affected (0.03 sec)mysql> grant ADMIN_PRIV on *.* to monitor@'192.168.9.%';Query OK, 0 rows affected (0.02 sec)然后回到mysql-proxy代理层节点上配置监控[root@mysql-proxy ~]# mysql -uadmin -padmin -P6032 -h127.0.0.1MySQL [(none)]> set mysql-monitor_username='monitor';Query OK, 1 row affected (0.000 sec)MySQL [(none)]> set mysql-monitor_password='P@ssword1!';Query OK, 1 row affected (0.000 sec)修改后，加载到RUNTIME，并保存到diskMySQL [(none)]> load mysql variables to runtime;Query OK, 0 rows affected (0.001 sec)MySQL [(none)]> save mysql variables to disk;Query OK, 94 rows affected (0.079 sec)验证监控结果：ProxySQL监控模块的指标都保存在monitor库的log表中。以下是连接是否正常的监控(对connect指标的监控)：注意：可能会有很多connect_error，这是因为没有配置监控信息时的错误，配置后如果connect_error的结果为NULL则表示正常。MySQL [(none)]> select * from mysql_server_connect_log;+---------------+------+------------------+-------------------------+---------------+| hostname     | port | time_start_us   | connect_success_time_us | connect_error |+---------------+------+------------------+-------------------------+---------------+| 192.168.9.211 | 9030 | 1548665195883957 | 762                     | NULL         || 192.168.9.212 | 9030 | 1548665195894099 | 399                     | NULL         || 192.168.9.213 | 9030 | 1548665195904266 | 483                     | NULL         || 192.168.9.211 | 9030 | 1548665255883715 | 824                     | NULL         || 192.168.9.212 | 9030 | 1548665255893942 | 656                     | NULL         || 192.168.9.211 | 9030 | 1548665495884125 | 615                     | NULL         || 192.168.9.212 | 9030 | 1548665495894254 | 441                     | NULL         || 192.168.9.213 | 9030 | 1548665495904479 | 638                     | NULL         || 192.168.9.211 | 9030 | 1548665512917846 | 487                     | NULL         || 192.168.9.212 | 9030 | 1548665512928071 | 994                     | NULL         || 192.168.9.213 | 9030 | 1548665512938268 | 613                     | NULL         |+---------------+------+------------------+-------------------------+---------------+20 rows in set (0.000 sec)以下是对心跳信息的监控(对ping指标的监控)MySQL [(none)]> select * from mysql_server_ping_log;+---------------+------+------------------+----------------------+------------+| hostname     | port | time_start_us   | ping_success_time_us | ping_error |+---------------+------+------------------+----------------------+------------+| 192.168.9.211 | 9030 | 1548665195883407 | 98                   | NULL       || 192.168.9.212 | 9030 | 1548665195885128 | 119                 | NULL       |...........| 192.168.9.213 | 9030 | 1548665415889362 | 106                 | NULL       || 192.168.9.213 | 9030 | 1548665562898295 | 97                   | NULL       |+---------------+------+------------------+----------------------+------------+110 rows in set (0.001 sec)read_only日志此时也为空(正常来说，新环境配置时，这个只读日志是为空的)MySQL [(none)]> select * from mysql_server_read_only_log;Empty set (0.000 sec)3个节点都在hostgroup_id=10的组中。现在，将刚才mysql_replication_hostgroups表的修改加载到RUNTIME生效。MySQL [(none)]> load mysql servers to runtime;Query OK, 0 rows affected (0.003 sec)MySQL [(none)]> save mysql servers to disk;Query OK, 0 rows affected (0.361 sec)现在看结果MySQL [(none)]> select hostgroup_id,hostname,port,status,weight from mysql_servers;+--------------+---------------+------+--------+--------+| hostgroup_id | hostname     | port | status | weight |+--------------+---------------+------+--------+--------+| 10           | 192.168.9.211 | 9030 | ONLINE | 1     || 20           | 192.168.9.212 | 9030 | ONLINE | 1     || 20           | 192.168.9.213 | 9030 | ONLINE | 1     |+--------------+---------------+------+--------+--------+3 rows in set (0.000 sec)

6 配置 mysql_users

上面的所有配置都是关于后端 MySQL 节点的，现在可以配置关于 SQL 语句的，包括：发送 SQL 语句的用户、SQL 语句的路由规则、SQL 查询的缓存和 SQL 语句的重写等。本小节是 SQL 请求所使用的用户配置，例如 root 用户，这要求我们需要先在后端 Doris FE 节点添加好相关用户。

这里以 root 和 doris 两个用户名为例。

首先，在Doris FE master主数据库节点上执行：[root@doris01 ~]# mysql -P9030 -uroot -p.........root用户已经存在，我们直接创建doris用户mysql> create user doris@'%' identified by 'P@ssword1!';Query OK, 0 rows affected, 1 warning (0.04 sec)mysql> grant ADMIN_PRIV on *.* to doris@'%';Query OK, 0 rows affected, 1 warning (0.03 sec)然后回到mysql-proxy代理层节点，配置mysql_users表，将刚才的两个用户添加到该表中。admin> insert into mysql_users(username,password,default_hostgroup) values('root','',10);Query OK, 1 row affected (0.001 sec) admin> insert into mysql_users(username,password,default_hostgroup) values('doris','P@ssword1!',10);Query OK, 1 row affected (0.000 sec) admin> load mysql users to runtime;Query OK, 0 rows affected (0.001 sec) admin> save mysql users to disk;Query OK, 0 rows affected (0.108 sec) mysql_users表有不少字段，最主要的三个字段为username、password和default_hostgroup：- username：前端连接ProxySQL，以及ProxySQL将SQL语句路由给MySQL所使用的用户名。- password：用户名对应的密码。可以是明文密码，也可以是hash密码。如果想使用hash密码，可以先在某个MySQL节点上执行  select password(PASSWORD)，然后将加密结果复制到该字段。- default_hostgroup：该用户名默认的路由目标。例如，指定root用户的该字段值为10时，则使用root用户发送的SQL语句默认  情况下将路由到hostgroup_id=10组中的某个节点。admin> select * from mysql_users\G*************************** 1. row ***************************            username: root            password:              active: 1              use_ssl: 0    default_hostgroup: 10      default_schema: NULL        schema_locked: 0transaction_persistent: 1        fast_forward: 0              backend: 1            frontend: 1      max_connections: 10000*************************** 2. row ***************************            username: doris            password: P@ssword1!              active: 1              use_ssl: 0    default_hostgroup: 10      default_schema: NULL        schema_locked: 0transaction_persistent: 1        fast_forward: 0              backend: 1            frontend: 1      max_connections: 100002 rows in set (0.000 sec) 虽然这里没有详细介绍mysql_users表，但上面标注了"注意本行"的两个字段必须要引起注意。只有active=1的用户才是有效的用户。至于transaction_persistent字段，当它的值为1时，表示事务持久化：当某连接使用该用户开启了一个事务后，那么在事务提交/回滚之前，所有的语句都路由到同一个组中，避免语句分散到不同组。在以前的版本中，默认值为0，不知道从哪个版本开始，它的默认值为1。我们期望的值为1，所以在继续下面的步骤之前，先查看下这个值，如果为0，则执行下面的语句修改为1。MySQL [(none)]> update mysql_users set transaction_persistent=1 where username='root';Query OK, 1 row affected (0.000 sec)MySQL [(none)]> update mysql_users set transaction_persistent=1 where username='sqlsender';Query OK, 1 row affected (0.000 sec)MySQL [(none)]> load mysql users to runtime;Query OK, 0 rows affected (0.001 sec)MySQL [(none)]> save mysql users to disk;Query OK, 0 rows affected (0.123 sec)这样就可以通过sql客户端，使用doris的用户名密码去连接了ProxySQL了

7 通过 ProxySQL 链接 Doris 测试

下面分别使用 root 用户和 doris 用户测试下它们是否能路由到默认的 hostgroup_id=10 (它是一个写组) 读数据。下面是通过转发端口 6033 连接的，连接的是转发到后端真正的数据库！

[root@mysql-master ~]#mysql -uroot -p -P6033 -hdoris01 -e "show databases;"Enter password:ERROR 9001 (HY000) at line 1: Max connect timeout reached while reaching hostgroup 10 after 10000ms这个时候发现出错，并没有转发到后端真正的doris fe上通过日志看到有set autocommit=0这样开启事务检查配置发现：mysql-forward_autocommit=falsemysql-autocommit_false_is_transaction=false我们这里不需要读写分离，只需要将这两个参数通过下面语句直接搞成true就可以了mysql> UPDATE global_variables SET variable_value='true' WHERE variable_name='mysql-forward_autocommit';Query OK, 1 row affected (0.00 sec)mysql> UPDATE global_variables SET variable_value='true' WHERE variable_name='mysql-autocommit_false_is_transaction';Query OK, 1 row affected (0.01 sec)mysql> LOAD MYSQL VARIABLES TO RUNTIME;Query OK, 0 rows affected (0.00 sec)mysql> SAVE MYSQL VARIABLES TO DISK;Query OK, 98 rows affected (0.12 sec)然后我们在重新试一下，显示成功[root@doris01 ~]# mysql -udoris -pP@ssword1! -P6033 -h192.168.9.211 -e "show databases;"Warning: Using a password on the command line interface can be insecure.+--------------------+| Database           |+--------------------+| doris_audit_db     || information_schema || retail             |+--------------------+

OK，配置过程就到此就结束了，你就可以用 Mysql 客户端、JDBC 等任何连接 MySQL 的方式连接 ProxySQL 去操作你的 Doris 了！注：MySQL 驱动版本要求 8.0.15

欢迎扫码关注：

Apache Doris(incubating)官方公众号

相关链接：

Apache Doris 官方网站：

http://doris.incubator.apache.org

Apache Doris Github：

https://github.com/apache/incubator-doris

Apache Doris 开发者邮件组：

dev@doris.apache.org