1. Quick start: 5分でリモートレプリカを構築する
本番稼働中のDonorノード(MySQL 8.0)から、緊急でReplicaノードを新規構築しなければならないケースを考えてみましょう。従来の手法であれば、mysqldumpを実行し、ファイルを圧縮してネットワーク経由でscp転送していました。しかし500GB規模のデータベースでは、この一連の作業に十数時間もかかってしまいます。Clone Pluginを使えば、そうした煩雑なステップを完全にスキップ可能です。すべての操作は数行のSQLコマンドだけで完結します。
ステップ 1: DonorとRecipientの両方にプラグインをインストール
ターミナルを開き、両ノード(Donor: 192.168.1.10、Recipient: 192.168.1.20)のMySQLに接続します:
INSTALL PLUGIN clone SONAME 'mysql_clone.so';
-- プラグインのステータスを確認
SELECT PLUGIN_NAME, PLUGIN_STATUS FROM INFORMATION_SCHEMA.PLUGINS WHERE PLUGIN_NAME = 'clone';
結果としてACTIVEが返ってくれば、プラグインの準備は完了です。
ステップ 2: Donor側でユーザー作成と権限付与
Donorノードでは、レプリカがInnoDBの物理スナップショットを取得できるよう、BACKUP_ADMIN権限を付与する必要があります:
CREATE USER 'clone_user'@'%' IDENTIFIED BY 'MatKhauSieuKho123!';
GRANT BACKUP_ADMIN ON *.* TO 'clone_user'@'%';
FLUSH PRIVILEGES;
ステップ 3: Recipient側の設定とCloneコマンドの実行
Recipientノード側では、データディレクトリの上書き権限(CLONE_ADMIN)を持つローカルユーザーを作成します。続いてDonorのIPをホワイトリストに追加し、クローン処理をトリガーします:
CREATE USER 'clone_local'@'localhost' IDENTIFIED BY 'MatKhauLocal123!';
GRANT CLONE_ADMIN ON *.* TO 'clone_local'@'localhost';
-- clone_localでログインして実行:
SET GLOBAL clone_valid_donor_list = '192.168.1.10:3306';
CLONE INSTANCE FROM 'clone_user'@'192.168.1.10':3306 IDENTIFIED BY 'MatKhauSieuKho123!';
コマンドが実行されると、Recipientは既存のデータディレクトリを即座にクリーンアップします。そしてDonorからの物理ファイル全体がネットワークソケット経由でダイレクトに転送されます。転送完了後、mysqldデーモンが自動的に再起動します。サーバーのブートが完了すれば、データはDonorと完全に一致した状態になります。
2. 仕組み:Clone Pluginはバックグラウンドでどう動いているのか?
MySQL 8.0.17以前は、DBAにとって実質的にmysqldumpを使うかPercona XtraBackupを使うかの2択でした。論理ダンプはCPU負荷が非常に高く、数百GBのリストアには膨大な時間がかかります。XtraBackupは高速ですが、シェル操作やファイルコピー、OS権限の厳密な管理など運用のハードルがありました。
Clone Pluginは、InnoDBストレージエンジン層において以下の4つのフェーズを順次実行することで、この課題を根本から解決します:
- Drop Data: Recipientは新規データを受信する前に、古いデータディレクトリを完全に削除します。
- File Copy: DonorからRecipientへテーブルスペースファイル(
.ibd)を直接ストリーミングします。コピー中もDonorは通常通りINSERT、UPDATE、DELETEを処理可能です。大規模なテーブルロックは一切発生しません。 - Page Copy: ファイルコピー中に変更されたデータページ(pages)はメモリ上に収集され、残りのデータとしてRecipientへ転送されます。
- Redo Copy: クローンセッション中に発生したすべてのRedoログがRecipientへ送信されます。ターゲットノードでクラッシュリカバリが実行され、完全に一貫性のある状態(Consistent Snapshot)へとデータを復元します。
Clone Pluginはスナップショット確定時点のバイナリログ位置(Binary Log coordinatesまたはGTID)を正確に自動記録します。そのため、オフセットを推測したりbinlogを手動で探したりすることなく、即座にレプリケーションを開始できます。
3. 応用:レプリケーション接続の自動化とノード復旧
本番環境においてClone PluginをGTIDやInnoDB Clusterと組み合わせることで、ノード追加時の手動作業を大幅に削減できます。
Clone完了後のレプリケーション自動設定
クローンの実行中、Recipient側で別のセッションを開いて進捗状況をモニタリングできます:
SELECT STAGE, STATE, CURRENT_PAGE, TOTAL_PAGE,
ROUND(CURRENT_PAGE/TOTAL_PAGE*100, 2) AS '% Done'
FROM performance_schema.clone_progress;
インスタンスの再起動が完了したら、自動同期されたGTIDの位置を確認します:
SELECT * FROM performance_schema.clone_status\G
BINLOG_FILE、BINLOG_POSITION、GTID_EXECUTEDの各フィールドが確認できます。GTIDベースのクラスタであれば、手動でポジションを指定することなくチャネルを指定するだけで接続可能です:
CHANGE REPLICATION SOURCE TO
SOURCE_HOST = '192.168.1.10',
SOURCE_PORT = 3306,
SOURCE_USER = 'repl_user',
SOURCE_PASSWORD = 'ReplPassword123!',
SOURCE_AUTO_POSITION = 1;
START REPLICA;
Group ReplicationおよびInnoDB Clusterでの活用
MySQL Group Replicationでは、Clone PluginがDistributed Recovery(分散リカバリ)の基盤として採用されています。新規ノードが参加した場合や、長期間停止していたノードの復帰によりクラスタ上のbinlogがパージされていた場合でも、対象ノードは生存しているDonorを自動的に探索します。バックグラウンドで物理クローンが自律的に実行され、DevOpsの手を煩わせることなくクラスタの自己修復(Self-healing)が実現します。
4. 実践におけるノウハウと注意点
この機能を初めて導入した際、チームで冷や汗をかいたトラブルがありました。CLONE INSTANCEを実行した後、スレーブノードが突如ネットワークから消失し、オンラインに戻ってこなくなったのです。原因はsystemdサービスに自動再起動フラグが設定されていなかったことでした。運用で必ず押さえておくべき3つのポイントを紹介します:
1. クローン完了後にノードが停止したままになる
CLONE INSTANCEコマンドは、Recipient側のmysqldを能動的に停止して再起動します。systemdやDocker配下で運用している場合、プロセス監視デーモン側で自動再起動の設定が必須です。systemd環境では、サービス定義ファイルにRestart=alwaysまたはRestart=on-failureが記述されているか必ず確認してください。これが抜けているとサーバーはシャットダウンしたままとなり、SSHで手動起動する羽目になります。
2. DonorとRecipient間の環境の不一致
バイナリブロック単位の物理コピーであるため、両サーバーの環境仕様は厳密に一致している必要があります:
- MySQLのバージョン: マイナーバージョンまで完全に一致している必要があります。例えば8.0.32から8.0.35へのクローンはMySQLによって拒否されます。
- OSおよびCPUアーキテクチャ: 同一のOSファミリおよびCPUアーキテクチャ(例: x86_64同士。Ubuntu x86からMac MシリーズのARMへのクローンなどは不可)でなければなりません。
- InnoDB Block Size: 両ノードの
innodb_page_size変数の値が完全に一致している必要があります(デフォルトは16k)。
3. Donorノードにおけるネットワーク帯域の枯渇
1Gbpsネットワーク上で500GBのデータベースをクローンすると、DonorのNIC使用率は容易に上限(約110MB/s〜120MB/s)に達します。この状態になるとユーザーリクエストが滞留し、レイテンシスパイクの原因となります。Donor側でクローンの帯域幅をあらかじめ制限しておくことをおすすめします:
-- アプリケーションの帯域を確保するため、クローン転送速度を80MB/sに制限
SET GLOBAL clone_max_data_bandwidth = 80;
逆に、10Gbpsの内部ネットワークと高速NVMeストレージを備えた環境であれば、ワーカースレッド数を増やして所要時間を短縮できます:
SET GLOBAL clone_max_concurrency = 16;
Clone Pluginをマスターすれば、1TB規模のリードレプリカの追加拡張も30〜40分足らずで完了し、システムのDR(災害復旧)運用も劇的に効率化されます。
