説明
このステートメントは、ログストリームのレプリカを削除するために使用します。
使用上の制限と注意事項
レプリカを削除した後もログストリームが多数派を維持できることを確認してください。そうでない場合、運用コマンドがエラーになります。
このステートメントは一度に1つのレプリカしか削除できません。
テナント内の同一ログストリームについて、レプリカ移行タスクは複数並列実行可能ですが、その他のディザスタリカバリタスク(レプリカの追加、削除、タイプ変換、ログストリームの法定メンバー数の変更など)は、1回につき1つしか実行できません。
説明
sysテナントはビュー
CDB_OB_LS_REPLICA_TASKSで、ユーザーテナントはビューDBA_OB_LS_REPLICA_TASKSで、実行中のディザスタリカバリタスクがあるかどうかを確認できます。
権限要件
このステートメントを実行するユーザーはALTER SYSTEM権限を持っている必要があります。OceanBaseデータベースの権限の詳細については、MySQLモードの権限分類およびOracleモードの権限分類を参照してください。
構文
ALTER SYSTEM REMOVE REPLICA
LS [=] ls_id
SERVER [=] 'svr_ip:svr_port'
[PAXOS_REPLICA_NUM [=] paxos_replica_num]
[TENANT [=] 'tenant_name'];
パラメータ説明
パラメータ |
説明 |
|---|---|
| ls_id | 削除対象レプリカのログストリームIDを指定します。 |
| svr_ip:svr_port | 削除対象レプリカが存在するサーバーのIPアドレスとポート番号を指定します。例:xxx.xx.xxx.001:2882。 |
| paxos_replica_num | オプションです。ログストリームのリーダーレプリカにおける過半数メンバー数を指定します。この値を明示的に指定しない場合、システムは現在のデフォルト値である paxos_replica_num を使用します。また、同一ログストリームのFレプリカ数は最大7個までです。
注意このパラメータの値を指定する場合、以下の条件を満たす必要があります:
|
| tenant_name | オプションです。操作対象のテナントを指定します。操作対象のテナントを明示的に指定しない場合、デフォルトテナント名は現在のテナント名になります。
注意
|
例
sysテナントで以下のコマンドを実行し、テナントmysql001のログストリームレプリカを1つ削除します。
ALTER SYSTEM REMOVE REPLICA
LS = 1001
SERVER = 'xxx.xxx.xxx.001:2882'
PAXOS_REPLICA_NUM = 2
TENANT = 'mysql001';
ログストリームレプリカの削除に関するその他の例については、レプリカの削減を参照してください。
関連ドキュメント
- ログストリームレプリカの手動追加に関する情報については、ADD REPLICAを参照してください。
- ログストリームレプリカタイプの変換に関する情報については、MODIFY REPLICAを参照してください。
- ログストリームレプリカの移行に関する情報については、MIGRATE REPLICAを参照してください。
- ログストリーム
PAXOS_REPLICA_NUMの変更に関する情報については、MODIFY PAXOS_REPLICA_NUMを参照してください。 - ログストリームレプリカタスクのキャンセルに関する情報については、CANCEL REPLICA TASKを参照してください。