InnoDB Cluster 是 MySQL 官方推出的高可用解決方案，整合了 MySQL Server、MySQL Shell 和 MySQL Router 等組件，能實(shí)現(xiàn)集群的自動(dòng)故障轉(zhuǎn)移、成員管理與模式切換，極大簡化了 MySQL 高可用架構(gòu)的部署與運(yùn)維。本文基于實(shí)際操作場景，整理了 InnoDB Cluster 日常管理中高頻使用的命令，涵蓋連接、狀態(tài)查詢、成員管理、主從切換等核心操作，助力運(yùn)維人員高效管控集群。

一、基礎(chǔ)準(zhǔn)備：連接 MySQL 實(shí)例

所有集群管理操作需通過 MySQL Shell 連接到集群中的任一實(shí)例（建議優(yōu)先連接主節(jié)點(diǎn)，如示例中的 192.168.184.151），命令格式如下：

# 格式：mysqlsh -u[用戶名] -p'[密碼]' -h[實(shí)例IP] -P[端口，默認(rèn)3306可省略]
mysqlsh -umgr_user -p'BgIka^123' -h192.168.184.151

注意：實(shí)際使用時(shí)需替換 mgr_user（集群管理用戶）、BgIka^123（用戶密碼）和 192.168.184.151（實(shí)例IP）為自身環(huán)境信息，密碼建議避免明文輸入，可省略 -p 后手動(dòng)交互輸入。

二、集群狀態(tài)與結(jié)構(gòu)查詢

連接實(shí)例后，需先定義集群變量（后續(xù)操作通過該變量調(diào)用集群方法），再執(zhí)行狀態(tài)、結(jié)構(gòu)與配置的查詢命令，掌握集群當(dāng)前健康度。

1. 定義集群變量

首次操作需通過集群名稱（示例為 Cluster01）獲取集群對(duì)象，后續(xù)命令可直接通過 cluster 變量調(diào)用：

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

2. 查看集群整體狀態(tài)

查詢集群成員列表、角色（主/從）、健康狀態(tài)、復(fù)制狀態(tài)等核心信息，是運(yùn)維中最常用的檢查命令：

cluster.status();

執(zhí)行后會(huì)返回類似如下關(guān)鍵信息：

• 集群名稱與版本
• 各成員實(shí)例的 IP:端口、角色（PRIMARY/SECONDARY）
• 復(fù)制同步狀態(tài)（SYNCED/ERROR）
• 集群整體健康度（OK/WARNING/ERROR）

3. 顯示集群詳細(xì)結(jié)構(gòu)

查看集群成員的具體配置（如實(shí)例地址、權(quán)重、故障轉(zhuǎn)移優(yōu)先級(jí)等），便于確認(rèn)成員屬性：

cluster.describe();

4. 查看集群配置選項(xiàng)

查詢集群的全局配置，如故障轉(zhuǎn)移超時(shí)時(shí)間、復(fù)制延遲閾值、多主模式開關(guān)等：

cluster.options();

三、集群成員管理：增刪實(shí)例

根據(jù)業(yè)務(wù)需求（如擴(kuò)容、下線故障實(shí)例），需對(duì)集群成員進(jìn)行添加或移除操作，操作前建議先通過 cluster.status() 確認(rèn)目標(biāo)實(shí)例狀態(tài)。

1. 移除集群成員

移除實(shí)例前需確保該實(shí)例處于 SECONDARY 角色（主節(jié)點(diǎn)需先切換角色），命令支持 IP:端口 或 主機(jī)名:端口 兩種格式：

# 1. 先確認(rèn)集群狀態(tài)，找到目標(biāo)實(shí)例（示例為 192.168.184.153）
cluster.status();
# 2. 移除實(shí)例（二選一，根據(jù)環(huán)境選擇地址格式）
cluster.removeInstance('mgr_user@192.168.184.153:3306');
# 或使用主機(jī)名（需確保主機(jī)間能解析）
cluster.removeInstance('mgr_user@maria-03:3306');
# 3. 移除后再次確認(rèn)狀態(tài)，確保實(shí)例已從集群中刪除
cluster.status();

2. 添加集群成員

添加新實(shí)例前需確保：實(shí)例已初始化、與集群其他節(jié)點(diǎn)網(wǎng)絡(luò)互通、數(shù)據(jù)已同步（或支持自動(dòng)增量同步），命令格式與移除類似：

# 二選一，添加 192.168.184.153 實(shí)例到集群
cluster.addInstance('mgr_user@192.168.184.153:3306');
# 或使用主機(jī)名
cluster.addInstance('mgr_user@maria-03:3306');

添加成功后，新實(shí)例會(huì)自動(dòng)加入復(fù)制集群，角色默認(rèn)為 SECONDARY。

四、主節(jié)點(diǎn)管理：手動(dòng)切換與模式切換

InnoDB Cluster 支持 單主模式（默認(rèn)，僅一個(gè) PRIMARY 節(jié)點(diǎn)）和 多主模式（多個(gè) PRIMARY 節(jié)點(diǎn)，支持并行寫入），可根據(jù)業(yè)務(wù)寫入需求切換模式，或手動(dòng)指定主節(jié)點(diǎn)。

1. 手動(dòng)切換主節(jié)點(diǎn)（單主模式下）

當(dāng)原主節(jié)點(diǎn)需維護(hù)（如升級(jí)）時(shí)，可手動(dòng)將 SECONDARY 節(jié)點(diǎn)切換為新主節(jié)點(diǎn)，命令如下：

# 格式：cluster.setPrimaryInstance('管理用戶@目標(biāo)實(shí)例地址')
cluster.setPrimaryInstance('mgr_user@192.168.184.153:3306');
# 或使用主機(jī)名
cluster.setPrimaryInstance('mgr_user@maria-03:3306');

注意：切換過程中集群會(huì)短暫停止寫入，建議在業(yè)務(wù)低峰期執(zhí)行，且確保目標(biāo)節(jié)點(diǎn)數(shù)據(jù)與原主節(jié)點(diǎn)完全同步。

2. 切換為多主模式

多主模式適用于分布式寫入場景（需確保業(yè)務(wù)無寫入沖突），切換命令需在主節(jié)點(diǎn)的 MySQL Shell 中執(zhí)行：

# 在 192.168.184.151（原主節(jié)點(diǎn)）的 MySQL Shell 中執(zhí)行
cluster.switchToMultiPrimaryMode();
# 查看切換后狀態(tài)（所有節(jié)點(diǎn)角色變?yōu)?PRIMARY）
cluster.status();

3. 切換回單主模式

若業(yè)務(wù)不再需要多主寫入，可切換回單主模式，并指定新的主節(jié)點(diǎn)（示例為 maria-01:3306）：

# 格式：cluster.switchToSinglePrimaryMode('目標(biāo)主節(jié)點(diǎn)地址')
cluster.switchToSinglePrimaryMode('maria-01:3306');
# 查看切換后狀態(tài)（僅指定節(jié)點(diǎn)為 PRIMARY，其余為 SECONDARY）
cluster.status();

五、復(fù)制與成員信息深度查詢

1. 查看復(fù)制統(tǒng)計(jì)信息

通過查詢 MySQL 系統(tǒng)表 performance_schema.replication_group_member_stats，可監(jiān)控 MySQL 組復(fù)制（Group Replication）中單個(gè)成員節(jié)點(diǎn)的事務(wù)處理狀態(tài)、沖突情況及隊(duì)列信息，是排查復(fù)制延遲、數(shù)據(jù)一致性問題的關(guān)鍵視圖。以下逐字段解析含義，并結(jié)合示例數(shù)據(jù)說明實(shí)際意義：

SELECT * FROM performance_schema.replication_group_member_stats\G

1. 基礎(chǔ)標(biāo)識(shí)字段（定位成員與復(fù)制通道）

2. 事務(wù)隊(duì)列與校驗(yàn)統(tǒng)計(jì)（監(jiān)控事務(wù)流轉(zhuǎn)效率）

3. 事務(wù)提交與沖突歷史（追溯數(shù)據(jù)一致性狀態(tài)）

4. 本地與遠(yuǎn)程事務(wù)細(xì)分（區(qū)分事務(wù)來源）

示例數(shù)據(jù)整體結(jié)論
從當(dāng)前查詢結(jié)果可判斷：

1. 集群狀態(tài)健康：無事務(wù)隊(duì)列積壓（0）、無沖突（0）、無本地回滾（0）；
2. 數(shù)據(jù)完全一致：所有校驗(yàn)通過的事務(wù)（6個(gè)遠(yuǎn)程+1個(gè)本地）均已在全集群提交；
3. 復(fù)制效率正常：遠(yuǎn)程事務(wù)應(yīng)用及時(shí)，無延遲風(fēng)險(xiǎn)。

2. 查看集群成員列表（全節(jié)點(diǎn)通用）

在任一集群實(shí)例中執(zhí)行以下 SQL，可查看所有成員的 ID、地址、角色與狀態(tài)：

SELECT * FROM performance_schema.replication_group_members;

返回結(jié)果包含：

• MEMBER_HOST：成員IP/主機(jī)名
• MEMBER_PORT：端口
• MEMBER_ROLE：角色（PRIMARY/SECONDARY）
• MEMBER_STATE：狀態(tài)（ONLINE/OFFLINE/RECOVERING）

3. 列出關(guān)聯(lián)的 MySQL Router 實(shí)例

MySQL Router 是集群的入口，負(fù)責(zé)流量分發(fā)，通過以下命令可查看當(dāng)前與集群關(guān)聯(lián)的 Router 實(shí)例信息（如 Router 名稱、地址、版本）：

# 在主節(jié)點(diǎn)（如 192.168.184.151）的 MySQL Shell 中執(zhí)行
cluster.listRouters();

六、組復(fù)制啟停（應(yīng)急操作）

組復(fù)制（Group Replication）是 InnoDB Cluster 實(shí)現(xiàn)高可用的核心機(jī)制，若需臨時(shí)下線某節(jié)點(diǎn)（如修復(fù)故障），可手動(dòng)啟停該節(jié)點(diǎn)的組復(fù)制。

1. 關(guān)閉組復(fù)制（目標(biāo)節(jié)點(diǎn)執(zhí)行）

在需下線的節(jié)點(diǎn)（示例為 192.168.184.153）的 MySQL Shell 中執(zhí)行：

# 關(guān)閉當(dāng)前節(jié)點(diǎn)的組復(fù)制
STOP GROUP_REPLICATION;
# 切換到主節(jié)點(diǎn)（192.168.184.151）查看集群狀態(tài)，確認(rèn)該節(jié)點(diǎn)已離線
cluster.status();

2. 啟動(dòng)組復(fù)制（目標(biāo)節(jié)點(diǎn)執(zhí)行）

故障修復(fù)后，在該節(jié)點(diǎn)（192.168.184.152）的 MySQL Shell 中重啟組復(fù)制，節(jié)點(diǎn)會(huì)自動(dòng)重新加入集群：

# 啟動(dòng)當(dāng)前節(jié)點(diǎn)的組復(fù)制
START GROUP_REPLICATION;
# 切換到主節(jié)點(diǎn)查看狀態(tài)，確認(rèn)該節(jié)點(diǎn)已重新上線（狀態(tài)變?yōu)?ONLINE）
cluster.status();

七、操作注意事項(xiàng)

1. 權(quán)限與安全：集群管理用戶（如 mgr_user）需具備 GROUP_REPLICATION_ADMIN、CLUSTER_ADMIN 等權(quán)限；生產(chǎn)環(huán)境中避免明文輸入密碼，建議通過 MySQL 密鑰文件或交互輸入。
2. 數(shù)據(jù)備份：執(zhí)行成員刪除、模式切換等關(guān)鍵操作前，需對(duì)集群數(shù)據(jù)進(jìn)行全量備份，防止操作失誤導(dǎo)致數(shù)據(jù)丟失。
3. 網(wǎng)絡(luò)與解析：集群節(jié)點(diǎn)間需確保 3306（數(shù)據(jù)庫端口）、33061（組復(fù)制端口）等端口互通；若使用主機(jī)名（如 maria-03），需配置節(jié)點(diǎn)間的主機(jī)名解析（如 /etc/hosts）。
4. 狀態(tài)校驗(yàn)：所有操作前后均建議執(zhí)行 cluster.status() 校驗(yàn)集群狀態(tài)，確保無 ERROR 或 OFFLINE 節(jié)點(diǎn)后再繼續(xù)操作。

結(jié)語

本文整理的命令覆蓋了 InnoDB Cluster 從連接、查詢到成員管理、模式切換的核心場景，是日常運(yùn)維的“工具箱”。實(shí)際使用中，需結(jié)合業(yè)務(wù)場景（如單主/多主、讀寫分離）與集群規(guī)模靈活調(diào)整，同時(shí)建議參考 MySQL 官方文檔 深入理解命令背后的原理，確保集群長期穩(wěn)定運(yùn)行。

到此這篇關(guān)于MySQL InnoDB Cluster 常見管理命令的文章就介紹到這了,更多相關(guān)MySQL InnoDB Cluster 管理命令內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論