MySQL InnoDB Cluster 常见管理命令

InnoDB Cluster 是 MySQL 官方推出的高可用解决方案，整合了 MySQL Server、MySQL Shell 和 MySQL Router 等组件，能实现集群的自动故障转移、成员管理与模式切换，极大简化了 MySQL 高可用架构的部署与运维。本文基于实际操作场景，整理了 InnoDB Cluster 日常管理中高频使用的命令，涵盖连接、状态查询、成员管理、主从切换等核心操作，助力运维人员高效管控集群。

一、基础准备：连接 MySQL 实例

所有集群管理操作需通过 MySQL Shell 连接到集群中的任一实例（建议优先连接主节点，如示例中的 192.168.184.151），命令格式如下：

# 格式：mysqlsh -u[用户名] -p'[密码]' -h[实例IP] -P[端口，默认3306可省略]
mysqlsh -umgr_user -p'BgIka^123' -h192.168.184.151

注意：实际使用时需替换 mgr_user（集群管理用户）、BgIka^123（用户密码）和 192.168.184.151（实例IP）为自身环境信息，密码建议避免明文输入，可省略 -p 后手动交互输入。

二、集群状态与结构查询

连接实例后，需先定义集群变量（后续操作通过该变量调用集群方法），再执行状态、结构与配置的查询命令，掌握集群当前健康度。

1. 定义集群变量

首次操作需通过集群名称（示例为 Cluster01）获取集群对象，后续命令可直接通过 cluster 变量调用：

# 格式：var cluster = dba.getCluster('[集群名称]')
var cluster = dba.getCluster('Cluster01')

2. 查看集群整体状态

查询集群成员列表、角色（主/从）、健康状态、复制状态等核心信息，是运维中最常用的检查命令：

cluster.status();

执行后会返回类似如下关键信息：

• 集群名称与版本
• 各成员实例的 IP:端口、角色（PRIMARY/SECONDARY）
• 复制同步状态（SYNCED/ERROR）
• 集群整体健康度（OK/WARNING/ERROR）

3. 显示集群详细结构

查看集群成员的具体配置（如实例地址、权重、故障转移优先级等），便于确认成员属性：

cluster.describe();

4. 查看集群配置选项

查询集群的全局配置，如故障转移超时时间、复制延迟阈值、多主模式开关等：

cluster.options();

三、集群成员管理：增删实例

根据业务需求（如扩容、下线故障实例），需对集群成员进行添加或移除操作，操作前建议先通过 cluster.status() 确认目标实例状态。

1. 移除集群成员

移除实例前需确保该实例处于 SECONDARY 角色（主节点需先切换角色），命令支持 IP:端口 或 主机名:端口 两种格式：

# 1. 先确认集群状态，找到目标实例（示例为 192.168.184.153）
cluster.status();
# 2. 移除实例（二选一，根据环境选择地址格式）
cluster.removeInstance('mgr_user@192.168.184.153:3306');
# 或使用主机名（需确保主机间能解析）
cluster.removeInstance('mgr_user@maria-03:3306');
# 3. 移除后再次确认状态，确保实例已从集群中删除
cluster.status();

2. 添加集群成员

添加新实例前需确保：实例已初始化、与集群其他节点网络互通、数据已同步（或支持自动增量同步），命令格式与移除类似：

# 二选一，添加 192.168.184.153 实例到集群
cluster.addInstance('mgr_user@192.168.184.153:3306');
# 或使用主机名
cluster.addInstance('mgr_user@maria-03:3306');

添加成功后，新实例会自动加入复制集群，角色默认为 SECONDARY。

四、主节点管理：手动切换与模式切换

InnoDB Cluster 支持 单主模式（默认，仅一个 PRIMARY 节点）和 多主模式（多个 PRIMARY 节点，支持并行写入），可根据业务写入需求切换模式，或手动指定主节点。

1. 手动切换主节点（单主模式下）

当原主节点需维护（如升级）时，可手动将 SECONDARY 节点切换为新主节点，命令如下：

# 格式：cluster.setPrimaryInstance('管理用户@目标实例地址')
cluster.setPrimaryInstance('mgr_user@192.168.184.153:3306');
# 或使用主机名
cluster.setPrimaryInstance('mgr_user@maria-03:3306');

注意：切换过程中集群会短暂停止写入，建议在业务低峰期执行，且确保目标节点数据与原主节点完全同步。

2. 切换为多主模式

多主模式适用于分布式写入场景（需确保业务无写入冲突），切换命令需在主节点的 MySQL Shell 中执行：

# 在 192.168.184.151（原主节点）的 MySQL Shell 中执行
cluster.switchToMultiPrimaryMode();
# 查看切换后状态（所有节点角色变为 PRIMARY）
cluster.status();

3. 切换回单主模式

若业务不再需要多主写入，可切换回单主模式，并指定新的主节点（示例为 maria-01:3306）：

# 格式：cluster.switchToSinglePrimaryMode('目标主节点地址')
cluster.switchToSinglePrimaryMode('maria-01:3306');
# 查看切换后状态（仅指定节点为 PRIMARY，其余为 SECONDARY）
cluster.status();

五、复制与成员信息深度查询

1. 查看复制统计信息

通过查询 MySQL 系统表 performance_schema.replication_group_member_stats，可监控 MySQL 组复制（Group Replication）中单个成员节点的事务处理状态、冲突情况及队列信息，是排查复制延迟、数据一致性问题的关键视图。以下逐字段解析含义，并结合示例数据说明实际意义：

SELECT * FROM performance_schema.replication_group_member_stats\G

1. 基础标识字段（定位成员与复制通道）

2. 事务队列与校验统计（监控事务流转效率）

3. 事务提交与冲突历史（追溯数据一致性状态）

4. 本地与远程事务细分（区分事务来源）

示例数据整体结论
从当前查询结果可判断：

1. 集群状态健康：无事务队列积压（0）、无冲突（0）、无本地回滚（0）；
2. 数据完全一致：所有校验通过的事务（6个远程+1个本地）均已在全集群提交；
3. 复制效率正常：远程事务应用及时，无延迟风险。

2. 查看集群成员列表（全节点通用）

在任一集群实例中执行以下 SQL，可查看所有成员的 ID、地址、角色与状态：

SELECT * FROM performance_schema.replication_group_members;

返回结果包含：

• MEMBER_HOST：成员IP/主机名
• MEMBER_PORT：端口
• MEMBER_ROLE：角色（PRIMARY/SECONDARY）
• MEMBER_STATE：状态（ONLINE/OFFLINE/RECOVERING）

3. 列出关联的 MySQL Router 实例

MySQL Router 是集群的入口，负责流量分发，通过以下命令可查看当前与集群关联的 Router 实例信息（如 Router 名称、地址、版本）：

# 在主节点（如 192.168.184.151）的 MySQL Shell 中执行
cluster.listRouters();

六、组复制启停（应急操作）

组复制（Group Replication）是 InnoDB Cluster 实现高可用的核心机制，若需临时下线某节点（如修复故障），可手动启停该节点的组复制。

1. 关闭组复制（目标节点执行）

在需下线的节点（示例为 192.168.184.153）的 MySQL Shell 中执行：

# 关闭当前节点的组复制
STOP GROUP_REPLICATION;
# 切换到主节点（192.168.184.151）查看集群状态，确认该节点已离线
cluster.status();

2. 启动组复制（目标节点执行）

故障修复后，在该节点（192.168.184.152）的 MySQL Shell 中重启组复制，节点会自动重新加入集群：

# 启动当前节点的组复制
START GROUP_REPLICATION;
# 切换到主节点查看状态，确认该节点已重新上线（状态变为 ONLINE）
cluster.status();

七、操作注意事项

1. 权限与安全：集群管理用户（如 mgr_user）需具备 GROUP_REPLICATION_ADMIN、CLUSTER_ADMIN 等权限；生产环境中避免明文输入密码，建议通过 MySQL 密钥文件或交互输入。
2. 数据备份：执行成员删除、模式切换等关键操作前，需对集群数据进行全量备份，防止操作失误导致数据丢失。
3. 网络与解析：集群节点间需确保 3306（数据库端口）、33061（组复制端口）等端口互通；若使用主机名（如 maria-03），需配置节点间的主机名解析（如 /etc/hosts）。
4. 状态校验：所有操作前后均建议执行 cluster.status() 校验集群状态，确保无 ERROR 或 OFFLINE 节点后再继续操作。

结语

本文整理的命令覆盖了 InnoDB Cluster 从连接、查询到成员管理、模式切换的核心场景，是日常运维的“工具箱”。实际使用中，需结合业务场景（如单主/多主、读写分离）与集群规模灵活调整，同时建议参考 MySQL 官方文档 深入理解命令背后的原理，确保集群长期稳定运行。

到此这篇关于MySQL InnoDB Cluster 常见管理命令的文章就介绍到这了,更多相关MySQL InnoDB Cluster 管理命令内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

最新评论