レプリカの分散の調整

本記事では、クラスタ内の特定のテナントのローカリティを変更することで、そのテナント配下のログストリームのレプリカ分布を調整する方法について説明します。

ローカリティの変更手順および注意事項の詳細については、Localityの変更を参照してください。

前提条件

Localityを変更する前に、変更対象のZone上の各ノードのリソース割り当て状況を確認する必要があります。Zone上のノードのリソースが不足しており、テナントが必要とするリソースユニットを格納できない場合は、Localityの変更を実行できません。

Zone上の各ノードのリソース割り当て状況については、テナントとリソース情報の確認を参照してください。

注意事項

• テナントのLocalityは空にすることはできません。

• テナントのLocalityが変更されると、そのテナント配下のすべてのテーブルのレプリカ配置も自動的に変更されます。

• 前回のテナントLocalityの変更が完了する前に、新たなテナントLocalityの変更を実行することはできません。

• Localityの変更では一度に1つの操作のみを実行できます。例えば、Zone3をZone4に置き換える場合、直接置き換えることはできません。まずZone4を追加し、その後Zone3を削除する手順を行う必要があります。

• レプリカの追加により、テナントのLocalityがテナントのプライマリZoneと一致しなくなる可能性があります。追加したZoneがプライマリZone切り替えに関与する場合は、プライマリZoneを変更する必要があります。追加したZoneがプライマリZone切り替えに関与しない場合は、プライマリZoneを変更する必要はありません。

手順

例：テナント mysql001 の Locality を変更します。FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone3 から FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone4 に変更します。

1. root ユーザーでクラスタの sys テナントにログインします。

   obclient -h172.30.xxx.xxx -P2883 -uroot@sys#obdemo -pxxxx -A
   

2. oceanbase データベースに移動します。

   obclient>use oceanbase;
   

3. テナント mysql001 の Locality を変更する前の状態を確認します。

   obclient> SELECT TENANT_ID,TENANT_NAME,TENANT_TYPE,PRIMARY_ZONE,LOCALITY FROM oceanbase.DBA_OB_TENANTS;
   

   クエリ結果は次のとおりです：

   +-----------+-------------+-------------+-------------------+---------------------------------------------+
   | TENANT_ID | TENANT_NAME | TENANT_TYPE | PRIMARY_ZONE      | LOCALITY                                    |
   +-----------+-------------+-------------+-------------------+---------------------------------------------+
   |         1 | sys         | SYS         | zone1;zone2;zone3 | FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone3 |
   |      1001 | META$1002   | META        | zone1;zone2;zone3 | FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone3 |
   |      1002 | mysql001    | USER        | zone1;zone2;zone3 | FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone3 |
   +-----------+-------------+-------------+-------------------+---------------------------------------------+
   3 rows in set
   

   テナント mysql001 は zone1、zone2、zone3 にそれぞれフル機能レプリカを 1 つずつ持っていることが確認できます。

4. テナント mysql001 の Locality を変更し、zone4 にレプリカを追加します。

   obclient>ALTER TENANT mysql001 locality="FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone3, FULL{1}@zone4";
   

5. Locality 変更タスクの実行状態を確認します。

   obclient>SELECT * FROM oceanbase.DBA_OB_TENANT_JOBS WHERE JOB_TYPE = 'ALTER_TENANT_LOCALITY';
   

   クエリ結果は次のとおりです：

   +--------+-----------------------+------------+-------------+----------+----------------------------+----------------------------+-----------+---------------------------------------------------------------------------------------------+---------------------------------------------+----------------+-------------+
   | JOB_ID | JOB_TYPE              | JOB_STATUS | RESULT_CODE | PROGRESS | START_TIME                 | MODIFY_TIME                | TENANT_ID | SQL_TEXT                                                                                    | EXTRA_INFO                                  | RS_SVR_IP      | RS_SVR_PORT |
   +--------+-----------------------+------------+-------------+----------+----------------------------+----------------------------+-----------+---------------------------------------------------------------------------------------------+---------------------------------------------+----------------+-------------+
   |      1 | ALTER_TENANT_LOCALITY | SUCCESS    |        NULL |        0 | 2023-01-05 19:38:38.416011 | 2023-01-05 19:38:38.416011 |      1002 | ALTER TENANT mysql001 locality='FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone3, FULL{1}@zone4' | FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone3 | xx.xx.xx.237   |        2882 |
   +--------+-----------------------+------------+-------------+----------+----------------------------+----------------------------+-----------+---------------------------------------------------------------------------------------------+---------------------------------------------+----------------+-------------+
   1 row in set
   

   JOB_STATUS が SUCCESS の場合、Locality 変更タスクは正常に実行されたことを示します。

6. テナント mysql001 の Locality を変更し、zone3 のレプリカを削除します。

   obclient>ALTER TENANT mysql001 locality="FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone4";
   

7. Locality 変更タスクの実行状態を確認します。

   obclient>SELECT * FROM oceanbase.DBA_OB_TENANT_JOBS WHERE JOB_TYPE = 'ALTER_TENANT_LOCALITY';
   

   クエリ結果は次のとおりです：

   +--------+-----------------------+------------+-------------+----------+----------------------------+----------------------------+-----------+------------------------------------------------------------------------------+------------------------------------------------------------+----------------+-------------+
   | JOB_ID | JOB_TYPE              | JOB_STATUS | RESULT_CODE | PROGRESS | START_TIME                 | MODIFY_TIME                | TENANT_ID | SQL_TEXT                                                                     | EXTRA_INFO                                                 | RS_SVR_IP      | RS_SVR_PORT |
   +--------+-----------------------+------------+-------------+----------+----------------------------+----------------------------+-----------+------------------------------------------------------------------------------+------------------------------------------------------------+----------------+-------------+
   |      1 | ALTER_TENANT_LOCALITY | SUCCESS    |        NULL |        0 | 2023-01-05 19:38:38.416011 | 2023-01-05 19:38:38.416011 |      1002 | ALTER TENANT mysql001 locality='FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone4' | FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone3, FULL{1}@zone4 | xx.xx.xx.237   |        2882 |
   +--------+-----------------------+------------+-------------+----------+----------------------------+----------------------------+-----------+------------------------------------------------------------------------------+------------------------------------------------------------+----------------+-------------+
   1 row in set
   

   JOB_STATUS が SUCCESS の場合、Locality 変更タスクは正常に実行されたことを示します。

8. テナント mysql001 の Locality を変更した後の状態を確認します。

   obclient> SELECT TENANT_ID,TENANT_NAME,TENANT_TYPE,PRIMARY_ZONE,LOCALITY FROM oceanbase.DBA_OB_TENANTS;
   

   クエリ結果は次のとおりです：

   +-----------+-------------+-------------+-------------------+---------------------------------------------+
   | TENANT_ID | TENANT_NAME | TENANT_TYPE | PRIMARY_ZONE      | LOCALITY                                    |
   +-----------+-------------+-------------+-------------------+---------------------------------------------+
   |         1 | sys         | SYS         | zone1;zone2;zone3 | FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone3 |
   |      1001 | META$1002   | META        | zone1;zone2       | FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone4 |
   |      1002 | mysql001    | USER        | zone1;zone2       | FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone4 |
   +-----------+-------------+-------------+-------------------+---------------------------------------------+
   3 rows in set
   

   ステップ 3 とステップ 8 のクエリ結果を比較すると、テナント mysql001 の Locality は元の FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone3 から FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone4 に変更されました。これにより、テナント mysql001 は zone1、zone2、zone4 にそれぞれフル機能レプリカを 1 つずつ持つことになります。

ステップ 4 の実行後、レプリカを追加すると、テナントの Locality がプライマリゾーンと一致しなくなります。追加されたゾーンがプライマリレプリカ切り替えに関与する場合は、プライマリゾーンを変更する必要があります。プライマリゾーンの変更操作については、プライマリゾーンの調整を参照してください。追加されたゾーンがプライマリレプリカ切り替えに関与しない場合は、プライマリゾーンを変更する必要はありません。

関連ドキュメント

• ローカリティの紹介

• ローカリティの変更

• ローカリティの確認

• レプリカの追加

• レプリカの削除

• プライマリゾーンの調整