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

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

所有集群管理操作需通過 MySQL Shell 連接到集群中的任一實例（建議優(yōu)先連接主節(jié)點，如示例中的 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）為自身環(huán)境信息，密碼建議避免明文輸入，可省略 -p 后手動交互輸入。

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

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

1. 定義集群變量

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

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

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

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

cluster.status();

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

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

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

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

cluster.describe();

4. 查看集群配置選項

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

cluster.options();

三、集群成員管理：增刪實例

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

1. 移除集群成員

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

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

2. 添加集群成員

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

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

添加成功后，新實例會自動加入復(fù)制集群，角色默認為 SECONDARY。

四、主節(jié)點管理：手動切換與模式切換

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

1. 手動切換主節(jié)點（單主模式下）

當(dāng)原主節(jié)點需維護（如升級）時，可手動將 SECONDARY 節(jié)點切換為新主節(jié)點，命令如下：

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

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

2. 切換為多主模式

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

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

3. 切換回單主模式

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

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

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

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

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

SELECT * FROM performance_schema.replication_group_member_stats\G

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

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

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

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

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

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

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

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

SELECT * FROM performance_schema.replication_group_members;

返回結(jié)果包含：

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

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

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

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

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

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

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

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

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

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

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

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

七、操作注意事項

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

結(jié)語

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

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

最新評論