現在の PolarDB-X インスタンスを MySQL または PolarDB-X のプライマリインスタンスのセカンダリインスタンスとして設定し、プライマリ／セカンダリ間のレプリケーションリンクを確立します。
構文
CHANGE MASTER TO option [, option] ... [ channel_option ]
option: {
MASTER_HOST = 'host_name'
| MASTER_USER = 'user_name'
| MASTER_PASSWORD = 'password'
| MASTER_PORT = port_num
| MASTER_LOG_FILE = 'source_log_name'
| MASTER_LOG_POS = source_log_pos
| MASTER_LOG_TIME_SECOND = source_log_time
| SOURCE_HOST_TYPE = {RDS|POLARDBX|MYSQL}
| STREAM_GROUP = 'stream_group_name'
| WRITE_SERVER_ID = write_server_id
| TRIGGER_AUTO_POSITION = {FALSE|TRUE}
| WRITE_TYPE = {SPLIT|SERIAL|TRANSACTION}
| MODE = {INCREMENTAL|IMAGE}
| CONFLICT_STRATEGY = {OVERWRITE|INTERRUPT|IGNORE|DIRECT_OVERWRITE}
| IGNORE_SERVER_IDS = (server_id_list)
}
channel_option:
FOR CHANNEL channel
server_id_list:
[server_id [, server_id] ... ]注意事項
PolarDB-X V5.4.19 以降でサポートされます。
ネットワーク制限により、この文はセルフマネージドインスタンスにのみ適用可能です。Alibaba Cloud 管理コンソールから購入した PolarDB-X インスタンスに対しては、レプリケーションリンクを作成できません。
現在のインスタンスの特権アカウントを使用して、この文を実行してください。
プライマリインスタンスへの接続に指定するアカウントも、特権アカウントである必要があります。
パラメーター
| パラメーター | 説明 | デフォルト値 |
|---|---|---|
MASTER_HOST | プライマリインスタンスのアドレスです。 | — |
MASTER_USER | プライマリインスタンスへの接続に使用するユーザー名です。 | — |
MASTER_PASSWORD | プライマリインスタンスへの接続に使用するパスワードです。 | — |
MASTER_PORT | プライマリインスタンスへの接続に使用するポート番号です。 | — |
MASTER_LOG_FILE | プライマリインスタンス上のログファイル名です。 | — |
MASTER_LOG_POS | binlog レプリケーションを開始するログファイル内のオフセットです。 | — |
MASTER_LOG_TIME_SECOND | レプリケーションの開始時刻（UNIX タイムスタンプ：1970-01-01 00:00:00 UTC からの経過秒数）です。MASTER_LOG_FILE および MASTER_LOG_POS が指定されている場合は無視されます。 | — |
SOURCE_HOST_TYPE | プライマリインスタンスの種別です。プライマリインスタンスが PolarDB-X 2.0 インスタンスの場合、POLARDBX を指定します。有効な値： RDS、POLARDBX、MYSQL。 | MYSQL |
STREAM_GROUP | ストリームグループの名前です。プライマリインスタンスが PolarDB-X 2.0 インスタンスであり、そのマルチストリーム binlog サービスを利用する場合に必須です。 | — |
WRITE_SERVER_ID | 書き込みサーバーの ID です。 | — |
TRIGGER_AUTO_POSITION | プライマリインスタンスの最大オフセットを自動的に使用するかどうかを指定します。 | FALSE |
WRITE_TYPE | 書き込みモードです。有効な値： SPLIT（非トランザクション型のパラレルレプリケーション）、SERIAL（非トランザクション型のシリアルレプリケーション）、TRANSACTION（トランザクション型のシリアルレプリケーション）。 | SPLIT |
MODE | 同期モードです。有効な値： INCREMENTAL（増分データ同期のみ）、IMAGE（スキーマ同期、全量データ同期、および増分データ同期）。 | — |
CONFLICT_STRATEGY | 競合時の処理ポリシーです。有効な値： OVERWRITE（REPLACE INTO を使用して競合データを上書き）、INTERRUPT（競合時にレプリケーションを停止）、IGNORE（競合データをスキップ）、DIRECT_OVERWRITE。 | OVERWRITE |
IGNORE_SERVER_IDS | レプリケーション対象から除外するサーバーの ID です。 | — |
FOR CHANNEL | レプリケーションリンクの名前です。既存のリンク名と重複しないようにしてください。 | — |
例
タイムスタンプからレプリケーションを開始
タイムスタンプ 1713159938（2024-04-15 13:45:38）から同期を開始するレプリケーションリンクを作成します：
CHANGE MASTER TO
MASTER_HOST='pxc-YOURENDPOINT.com',
MASTER_PORT=3306,
MASTER_USER='polardbx',
MASTER_PASSWORD='123456',
SOURCE_HOST_TYPE=polardbx,
MASTER_LOG_TIME_SECOND=1713159938,
write_server_id=1944903859
FOR CHANNEL 'pxc-bjrcsnbyagcdxh';ログファイルのオフセットからレプリケーションを開始
binlog.000001 ファイルのオフセット 4 から同期を開始するレプリケーションリンクを作成します：
CHANGE MASTER TO
MASTER_HOST='pxc-YOURENDPOINT.com',
MASTER_PORT=3306,
MASTER_USER='polardbx',
MASTER_PASSWORD='123456',
SOURCE_HOST_TYPE=polardbx,
MASTER_LOG_FILE='binlog.000001',
MASTER_LOG_POS=4,
write_server_id=1944903859
FOR CHANNEL 'pxc-bjrcsnbyagcdxh';