説明
このステートメントは、ログストリームのレプリカを移行するために使用されます。つまり、対応するレプリカを指定された場所に移行します。
制限事項と注意点
レプリカの移行は同一ゾーン間でのみ実行できます。
レプリカ移行操作を実行する前に、ターゲットサーバー上にユーザーが利用可能なリソース、すなわちユニットが存在し、そのユニット上に該当するログストリームのレプリカがないことを確認する必要があります。
現在のログストリームに既に7つのFレプリカが存在する場合、移行コマンドの実行は許可されません。
このステートメントは一度に1つのログストリームレプリカしか移行できません。複数のレプリカを移行する必要がある場合は、このステートメントを複数回実行する必要があります。
テナント内の同一ログストリームについて、レプリカ移行タスクは並行して複数実行できますが、その他の災害復旧タスク(レプリカの追加、削除、レプリカタイプの変更、ログストリームの法定メンバー数の変更など)は毎回1つずつしか実行できません。
説明
sysテナントはビュー
CDB_OB_LS_REPLICA_TASKSを使用して、実行中の災害復旧タスクがあるかどうかを確認できます。ユーザーテナントはビューDBA_OB_LS_REPLICA_TASKSを使用して、実行中の災害復旧タスクがあるかどうかを確認できます。
権限要件
このステートメントを実行するユーザーはALTER SYSTEM権限を持っている必要があります。OceanBaseデータベースの権限の詳細については、MySQLモードの権限分類およびOracleモードの権限分類を参照してください。
構文
ALTER SYSTEM MIGRATE REPLICA
LS [=] ls_id
SOURCE [=] 'svr_ip:svr_port'
DESTINATION [=] 'destination_addr'
[DATA_SOURCE [=] 'data_source']
[TENANT [=] 'tenant_name'];
パラメータの説明
| パラメータ | 説明 |
|---|---|
| ls_id | 移行対象のレプリカのログストリームIDを指定します。 |
| svr_ip:svr_port | 移行対象のレプリカが存在するサーバーのIPアドレスとポート番号を指定します。例えば、xxx.xx.xxx.001:2882 のように記述します。 |
| destination_addr | 移行対象のレプリカのターゲットサーバーのIPアドレスとポート番号を指定します。書式は svr_ip:svr_port で、例:xxx.xx.xxx.002:2882 です。 |
| data_source | オプションで、レプリカのデータソースアドレスを指定します。ログストリーム内の他の任意のレプリカをデータソースアドレスとして選択できます。業務上の実際の状況に応じて選択してください。書式は svr_ip:svr_port で、例えば、xxx.xx.xxx.001:2882 です。この値を明示的に指定しない場合、システムは利用可能なデータソースを自動的に選択します。
注意指定したデータソースが利用不可能な場合、システムはエラーを報告します。 |
| tenant_name | オプションで、操作対象のテナントを指定します。操作対象のテナントを明示的に指定しない場合、デフォルトのテナント名は現在のテナント名になります。
注意システムテナントは他のテナントを指定できますが、ユーザーテナントは自身のテナントしか指定できません。このステートメントでは、 |
例
sysテナントで以下のコマンドを実行し、テナントmysql001内のxxx.xxx.xxx.001:2882上のログストリーム(1002)レプリカをxxx.xxx.xxx.002:2882に移行します。
ALTER SYSTEM MIGRATE REPLICA
LS = 1002
SOURCE = 'xxx.xxx.xxx.001:2882'
DESTINATION = 'xxx.xxx.xxx.002:2882'
TENANT = 'mysql001';
ログストリームレプリカの移行に関するその他の例については、レプリカ移行を参照してください。
関連ドキュメント
- ログストリームレプリカの手動追加に関する情報については、ADD REPLICAを参照してください。
- ログストリームレプリカの削除に関する情報については、REMOVE REPLICAを参照してください。
- ログストリームレプリカタイプの変換に関する情報については、MODIFY REPLICAを参照してください。
- ログストリーム
PAXOS_REPLICA_NUMの変更に関する情報については、MODIFY PAXOS_REPLICA_NUMを参照してください。 - ログストリームレプリカタスクのキャンセルに関する情報については、CANCEL REPLICA TASKを参照してください。