ALTER RESOURCE POOL

説明

ALTER RESOURCE POOL ステートメントは、リソースプールの属性を変更するために使用されます。これには、UNIT、UNIT_NUM、ZONE_LIST の変更が含まれます。

使用制限と注意事項

• ALTER RESOURCE POOL ステートメントでリソースプールの属性を変更する場合、1文につき1つの属性のみを変更できます。UNIT、UNIT_NUM、ZONE_LIST のうち2つ以上を同時に変更する必要がある場合は、複数のステートメントに分けて実行する必要があります。

• OceanBaseデータベースの現在のバージョンでは、テナントの同種ゾーンモードと異種ゾーンモードをサポートしています。同種ゾーンモードでは、テナント内の各ゾーンのユニット数が同じである必要があります。異種ゾーンモードでは、テナント内の各ゾーンのユニット数は異なっても構いませんが、1つのテナントで最大2種類の unit_num しか持てません。UNIT_NUM を増減する際：

  • 異種ゾーンモードでは、リソースプールが既にテナントに割り当てられているかどうかに関係なく、ALTER RESOURCE POOL ステートメントを使用して UNIT_NUM を増減できます。

    注意

    通常、既存のテナントやアップグレードされたテナントは、デフォルトで同種ゾーンモードになっています。異種ゾーンモードを有効にするには、構成パラメータ zone_deploy_mode の値を hetero（異種ゾーンモード）に変更する必要があります。変更後は、homo（同種ゾーンモード）に戻すことはできません。

  • 同種ゾーンモードでは、リソースプールが既にテナントに割り当てられている場合、ALTER RESOURCE POOL ステートメントは使用できません。変更には ALTER RESOURCE TENANT ステートメントを使用する必要があります。ALTER RESOURCE TENANT ステートメントの詳細については、ALTER RESOURCE TENANTを参照してください。

権限要件

リソースプールを変更できるのは sys テナントの root ユーザー（root@sys）のみです。他のテナントではリソースプールの変更はサポートされません。

構文

ALTER RESOURCE POOL

ALTER RESOURCE POOL pool_name
      UNIT [=] unit_name
    | UNIT_NUM [=] unit_num [DELETE UNIT = (unit_id_list)]
    | ZONE_LIST [=] ('zone_name' [, 'zone_name' ...]);

パラメータ説明

例

• リソースプール pool1 の複数のプロパティを同時に変更することはできません。例えば、次のステートメントでは UNIT、UNIT_NUM、ZONE プロパティを同時に変更しているため、実行時にエラーが発生します。

  obclient [oceanbase]> ALTER RESOURCE POOL pool1 UNIT='unit2', UNIT_NUM=1, ZONE_LIST=('zone1');
  ERROR 1235 (0A000): alter unit_num, resource_unit, zone_list in one cmd not supported
  

  特に、UNIT_NUM を減らす場合は、指定したユニットを削除できます。

  obclient [oceanbase]> ALTER RESOURCE POOL pool1 UNIT_NUM=1 DELETE UNIT = (1002);
  

• リソースプール pool1 が使用するリソース仕様を unit2 に変更します。

  obclient [oceanbase]> ALTER RESOURCE POOL pool1 UNIT='unit2';
  

関連ドキュメント

• リソースプールの確認

• リソースプールプロパティの変更