ADD REPLICA

説明

このステートメントは、ログストリームのレプリカを手動で追加するために使用されます。

制限事項と注意点

• レプリカの追加操作を実行する前に、ターゲットサーバー（Server）上にユーザーが利用可能なリソース（Unit）があり、そのUnit上に該当するログストリームのレプリカが存在しないことを確認する必要があります。

• システムテナント（sysテナント）はすべてのテナントのログストリームに対してレプリカの追加操作を実行できますが、ユーザーテナントは自身のテナントのログストリームに対してのみレプリカの追加操作を実行できます。

• このステートメントは一度に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'];

パラメータの説明

例

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を参照してください。