レプリカを設定(CHANGE REPLICATION SOURCE)

コマンド

CHANGE REPLICATION SOURCE TO SOURCE_HOST='source_host', SOURCE_PORT=3306, SOURCE_USER='replicator', SOURCE_PASSWORD='secret', SOURCE_AUTO_POSITION=1;

概要

GTIDベースの自動ポジショニングを使用して、指定したソースに追従するレプリカとしてこのサーバーを構成する。

使用する場面

新しいレプリカの設定、またはレプリケーションソースの変更に。

注意

これはMySQL 8.0.23以降の用語。古いバージョンではCHANGE MASTER TO ... MASTER_HOSTを使用する(8.0.23–8.3では別名、8.4で削除)。SOURCE_AUTO_POSITION=1にはGTIDの有効化(gtid_mode=ON)が必要。そうでない場合はSOURCE_LOG_FILEとSOURCE_LOG_POSを指定する必要がある。コマンド実行前にレプリケーションを停止する必要がある。レプリケーションユーザーが8.0以降のデフォルトであるcaching_sha2_passwordで作成されている場合、接続にはTLSが必要: SOURCE_SSL=1を追加するか、TLSなしの場合はGET_SOURCE_PUBLIC_KEY=1を設定する。そうしないとI/Oスレッドはエラー2061で接続に失敗する。