将MySQL路由器与InnoDB群集一起使用
本节介绍如何将MySQL路由器与InnoDB群集一起使用以实现高可用性。无论您是否部署了沙箱集群或生产集群,MySQL路由器都可以使用该--bootstrap
选项基于InnoDB集群的元数据进行自我配置。这将自动配置MySQL路由器,以将连接路由到群集的服务器实例。客户端应用程序连接到MySQL路由器提供的端口,而无需了解InnoDB集群拓扑。万一发生意外故障,InnoDB集群会自动进行自我调整,并且MySQL Router会检测到更改。这消除了客户端应用程序处理故障转移的需要。有关更多信息,请参见 MySQL InnoDB集群路由。。
注意不要尝试手动配置MySQL路由器以重定向到InnoDB集群的端口。始终使用该
--bootstrap
选项,因为这可确保MySQL Router从InnoDB集群的元数据中获取其配置。请参阅群集元数据和状态。
建议的MySQL Router部署与应用程序位于同一主机上。使用沙箱部署时,所有内容都在单个主机上运行,因此,您将MySQL Router部署到同一主机上。使用生产部署时,建议将一个MySQL路由器实例部署到用于承载一个客户端应用程序的每台计算机上。也可以将MySQL路由器部署到应用程序实例通过其连接的通用计算机上。
假设已经安装了MySQL Router(请参阅“安装MySQL Router”),请使用该--bootstrap
选项提供属于InnoDB集群的服务器实例的位置。MySQL路由器使用附带的元数据缓存插件来检索InnoDB集群的元数据,该元数据由构成InnoDB集群及其在集群中的角色的服务器实例地址列表组成。您传递MySQL路由器应从中检索InnoDB群集元数据的服务器的类似URI的连接字符串。例如:
shell>mysqlrouter --bootstrap icadmin@ic-1:3306 --user=mysqlrouter
系统会提示您输入要使用的MySQL实例的实例密码和加密密钥。该加密密钥用于加密MySQL路由器用于连接集群的实例密码。还会显示可用于连接到InnoDB集群的端口。在上述示例中,MySQL Router引导过程创建了一个mysqlrouter.conf
文件,其设置基于从从传递给该--bootstrap
选项的地址中检索到的集群元数据icadmin@ic-1:3306
。基于检索到的InnoDB集群元数据,MySQL Router自动配置mysqlrouter.conf
文件,包括一个metadata_cache
部分。如果您使用的是MySQL Router 8.0.14及更高版本,则--bootstrap
选项自动配置MySQL路由器来跟踪和存储活动的MySQL InnoDB集群元数据服务器地址,该地址由dynamic_state
。这样可以确保在重启MySQL路由器时,它知道哪个MySQL InnoDB集群元数据服务器地址是最新的。有关更多信息,请参见dynamic_state
文档。
在早期的MySQL Router版本中,元数据服务器信息是在Router的初始引导操作期间定义的,并像bootstrap_server_addresses
配置文件中一样静态存储,该文件包含集群中所有服务器实例的地址。例如:
[metadata_cache:prodCluster] router_id=1 bootstrap_server_addresses=mysql://icadmin@ic-1:3306,mysql://icadmin@ic-2:3306,mysql://icadmin@ic-3:3306 user=mysql_router1_jy95yozko3k2 metadata_cluster=prodCluster ttl=300小费
如果使用MySQL Router 8.0.13或更早版本,则在引导MySQL Router后通过添加另一个服务器实例来更改群集的拓扑时,需要bootstrap_server_addresses
根据更新的元数据进行更新。使用该--bootstrap
选项重新启动MySQL Router ,或手动编辑文件bootstrap_server_addresses
部分mysqlrouter.conf
并重新启动MySQL Router。
生成的MySQL路由器配置将创建用于连接到群集的TCP端口。默认情况下,将创建用于使用经典MySQL协议和X协议与集群通信的端口。要使用X协议,服务器实例必须安装并配置了X插件,这是MySQL 8.0及更高版本的默认设置。默认的可用TCP端口为:
6446
-对于经典的MySQL协议读写会话,MySQL路由器将传入的连接重定向到主服务器实例。6447
-对于经典的MySQL协议只读会话,MySQL路由器将传入的连接重定向到辅助服务器实例之一。64460
-对于X协议读写会话,MySQL路由器将传入的连接重定向到主服务器实例。64470
-对于X协议只读会话,MySQL路由器将传入的连接重定向到辅助服务器实例之一。
根据您的MySQL路由器配置,端口号可能与上述端口号不同。例如,如果您使用--conf-base-port
选项或group_replication_single_primary_mode
变量。启动MySQL Router时,将列出确切的端口。
传入连接的重定向方式取决于所使用群集的类型。当使用单一主群集时,默认情况下,MySQL路由器发布一个X协议和一个经典的MySQL协议端口,客户端连接到该端口以进行读写会话,并将客户端重定向到群集的单一主端口。对于多主群集,读写会话以循环方式重定向到主实例之一。例如,这意味着到端口6446的第一个连接将重定向到ic-1实例,到端口6446的第二个连接将重定向到ic-2实例,依此类推。对于传入的只读连接,MySQL路由器也以循环方式将连接重定向到辅助实例之一。routing_strategy
选项。
自举并配置后,启动MySQL Router。如果您在系统范围内使用该--bootstrap
选项进行安装,请发出:
shell>mysqlrouter &
如果使用--directory
选项将MySQL Router安装到目录中,请使用start.sh
安装目录中的脚本。或者,设置服务以在系统启动时自动启动MySQL路由器,请参阅启动MySQL路由器。您现在可以如上所述将MySQL客户端(例如MySQL Shell)连接到传入的MySQL路由器端口之一,并参见客户端如何透明地连接到InnoDB集群实例之一。
shell>mysqlsh --uri root@localhost:6442
要验证您实际连接到的实例,只需针对port
状态变量发出SQL查询。
mysql-js> \sql Switching to SQL mode... Commands endwith ; mysql-sql> select @@port; +-------- + | @@port | +-------- + | 3310 | +-------- +
测试高可用性
要测试高可用性是否有效,请通过杀死实例来模拟意外的停止。群集检测到实例已离开群集并重新配置自身的事实。集群本身如何真正进行重新配置取决于您使用的是单主集群还是多主集群,以及实例在集群中扮演的角色。
在单主要模式下:
- 如果当前主节点离开集群,则将辅助实例之一选作新的主实例,实例的优先级最低
server_uuid
。MySQL Router将读写连接重定向到新选出的主数据库。 - 如果当前辅助节点离开群集,则MySQL路由器将停止将只读连接重定向到该实例。
有关更多信息,请参见“单主模式”。
在多主要模式下:
- 如果当前的“ R / W”实例离开群集,则MySQL路由器会将读写连接重定向到其他主数据库。如果剩下的实例是群集中的最后一个主实例,则群集已完全消失,您将无法连接到任何MySQL路由器端口。
有关更多信息,请参见“多主模式”。
有多种方法可以模拟离开群集的实例,例如,您可以在实例上强制停止MySQL服务器,或者在dba.killSandboxInstance()
测试沙箱部署时使用AdminAPI 。在此示例中,假设有一个具有三个服务器实例的单主要沙箱群集部署,并且侦听端口3310的实例是当前主要实例。模拟实例意外离开集群:
mysql-js> dba.killSandboxInstance(3310)
群集检测到更改并自动选择一个新的主数据库。假设您的会话连接到默认的经典经典MySQL协议端口6446,MySQL路由器应检测到群集拓扑的更改,并将会话重定向到新选择的主服务器。要验证这一点,请使用以下\sql
命令在MySQL Shell中切换到SQL模式,然后选择实例的port
变量以检查您的会话已重定向到哪个实例。注意第一个SELECT
语句失败,因为与原始主数据库的连接已丢失。这意味着当前会话已经关闭,MySQL Shell为您自动重新连接,并且当您再次发出命令时,将确认新端口。
mysql-js> \sql Switching to SQL mode... Commands endwith ; mysql-sql> SELECT @@port; ERROR: 2013 (HY000): Lost connection to MySQL server during query The global session got disconnected. Attempting to reconnect to 'root@localhost:6446'... The global session was successfully reconnected. mysql-sql> SELECT @@port; +-------- + | @@port | +-------- + | 3330 | +-------- + 1 row in set (0.00 sec)
在此示例中,端口3330的实例已被选为新的主实例。这表明InnoDB集群为我们提供了自动故障转移,MySQL Router已自动将我们重新连接到新的主实例,并且我们具有高可用性。
MySQL路由器和元数据服务器
当MySQL路由器针对群集进行引导时,它将服务器实例的地址记录在其配置文件中。如果在引导MySQL路由器后将任何其他实例添加到群集,它们将不会自动检测到,因此不会用于连接路由。
为确保新添加的实例正确路由,您必须针对群集引导MySQL路由器以读取更新的元数据。这意味着您必须重新启动MySQL Router并包括该--bootstrap
选项。
使用群集的路由器
您可以针对群集或副本集引导MySQL路由器的多个实例。从8.0.19版本开始,要显示所有已注册的MySQL路由器实例的列表,请发出:
Cluster.listRouters()
结果提供有关每个已注册的MySQL路由器实例的信息,例如元数据中的名称,主机名,端口等。例如,发出:
mysql-js> Cluster.listRouters() { "clusterName": "example", "routers": { "ic-1:3306": { "hostname": "ic-1:3306", "lastCheckIn": "2020-01-16 11:43:45", "roPort": 6447, "roXPort": 64470, "rwPort": 6446, "rwXPort": 64460, "version": "8.0.19" } } }
返回的信息显示:
- MySQL路由器实例的名称。
- 上次签入时间戳,它是由存储在元数据中的MySQL路由器定期ping生成的
- 运行MySQL路由器实例的主机名
- MySQL路由器为经典MySQL协议连接发布的只读和读写端口
- MySQL路由器为X协议连接发布的只读和读写端口
- 此MySQL路由器实例的版本。
version
8.0.19中增加了对返回的支持。如果针对早期版本的MySQL Router运行此操作,则版本字段为null
。
另外,该Cluster.listRouters()
操作可以显示不支持MySQL Shell支持的元数据版本的实例列表。使用该onlyUpgradeRequired
选项,例如通过发出Cluster.listRouters({'onlyUpgradeRequired':'true'})
。返回的列表仅显示已向MySQL路由器实例注册的实例,Cluster
这些实例需要升级其元数据。请参见“升级InnoDB集群元数据”。
MySQL Router实例不会自动从元数据中删除,因此,例如,当您引导更多实例时,InnoDB群集元数据包含的实例引用数量正在不断增加。要从群集的元数据中删除已注册的MySQL路由器实例,请使用版本8.0.19中添加的操作。使用该操作获取要删除的MySQL路由器实例的名称,并将其作为传递。例如,假设您在集群中注册的MySQL路由器实例为:Cluster.removeRouterMetadata(router)
Cluster.listRouters()
router
mysql-js> Cluster.listRouters(){ "clusterName": "testCluster", "routers": { "myRouter1": { "hostname": "example1.com", "lastCheckIn":null , "routerId": "1", "roPort": "6447", "rwPort": "6446" "version":null }, "myRouter2": { "hostname": "example2.com", "lastCheckIn": "2019-11-27 16:25:00", "routerId": "3", "roPort": "6447", "rwPort": "6446" "version": "8.0.19" } } }
基于这样的事实,命名实例“ myRouter1 ”有null
对“ lastCheckIn ”和“版本”,我们决定通过发出删除从元数据这个旧的实例:
mysql-js> cluster.removeRouterMetadata('myRouter1')
通过从InnoDB集群元数据中删除指定的MySQL路由器实例,可以从集群中注销该实例。