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