ALTER RESOURCE UNIT

説明

ALTER RESOURCE UNIT ステートメントは、ユニットのリソース仕様を変更するために使用されます。リソース仕様の変更とは、主にCPU、メモリ、ログディスク容量などを増減させることです。

制限事項と注意点

リソース仕様を変更する前に、そのリソース仕様に対応するユニットがテナントによって使用されている場合、以下の点に注意する必要があります：

• リソース仕様を増やす場合、ユニットが配置されている各ノードに十分な残りのリソースが割り当て可能であることを確保する必要があります。

  ビュー GV$OB_SERVERS を照会することで、各ノードの総リソースおよび既に割り当てられたリソースを確認できます。詳細な操作については、テナントとリソース情報の表示を参照してください。

• リソース仕様を減らす場合、変更後のCPU、メモリ、ログディスク容量などのリソースの合計量が、現在のテナントが既に使用しているリソースの合計量以上であることを確保する必要があります。

権限要件

ユニットのリソース仕様を変更できるのは、sys テナントの root ユーザー (root@sys) のみです。他のテナントではユニットのリソース仕様の変更はサポートされていません。

ステートメント

ALTER RESOURCE UNIT unit_name
MEMORY_SIZE [=] 'size_value',
MAX_CPU [=] cpu_num,
[MIN_CPU [=] cpu_num,]
[MAX_IOPS [=] iops_num,]
[MIN_IOPS [=] iops_num,]
[IOPS_WEIGHT [=]iopsweight,]
[MAX_NET_BANDWIDTH [=] bandwidth_num,]
[NET_BANDWIDTH_WEIGHT [=] bandwidth_weight_num,]
[LOG_DISK_SIZE [=] 'size_value'];

パラメータの説明

例

1. リソースユニットunit1のリソース仕様を確認します。

   obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_UNIT_CONFIGS WHERE NAME='unit1';
   

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

   +----------------+-------+----------------------------+----------------------------+---------+---------+-------------+---------------+----------------+----------+----------+-------------+-------------------+----------------------+
   | UNIT_CONFIG_ID | NAME  | CREATE_TIME                | MODIFY_TIME                | MAX_CPU | MIN_CPU | MEMORY_SIZE | LOG_DISK_SIZE | DATA_DISK_SIZE | MAX_IOPS | MIN_IOPS | IOPS_WEIGHT | MAX_NET_BANDWIDTH | NET_BANDWIDTH_WEIGHT |
   +----------------+-------+----------------------------+----------------------------+---------+---------+-------------+---------------+----------------+----------+----------+-------------+-------------------+----------------------+
   |           1001 | unit1 | 2025-05-28 11:19:39.116490 | 2025-05-28 11:19:39.116490 |       4 |       4 |  5368709120 |   10737418240 |           NULL |     1280 |     1024 |           1 |           5242880 |                   10 |
   +----------------+-------+----------------------------+----------------------------+---------+---------+-------------+---------------+----------------+----------+----------+-------------+-------------------+----------------------+
   1 row in set
   

2. リソースユニットunit1のリソース仕様を変更します。CPUは2コア、メモリは5GB、各ユニットで使用可能な最大ネットワーク帯域幅は4MB、ネットワーク帯域幅の重みは8に設定します。

   obclient [oceanbase]> ALTER RESOURCE UNIT unit1 MAX_CPU 2, MIN_CPU 2, MEMORY_SIZE '5G', MAX_NET_BANDWIDTH '4M', NET_BANDWIDTH_WEIGHT 8;
   

3. 変更が成功した後、再度リソースユニットunit1のリソース仕様を確認します。

   obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_UNIT_CONFIGS WHERE NAME='unit1';
   

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

   +----------------+-------+----------------------------+----------------------------+---------+---------+-------------+---------------+----------------+----------+----------+-------------+-------------------+----------------------+
   | UNIT_CONFIG_ID | NAME  | CREATE_TIME                | MODIFY_TIME                | MAX_CPU | MIN_CPU | MEMORY_SIZE | LOG_DISK_SIZE | DATA_DISK_SIZE | MAX_IOPS | MIN_IOPS | IOPS_WEIGHT | MAX_NET_BANDWIDTH | NET_BANDWIDTH_WEIGHT |
   +----------------+-------+----------------------------+----------------------------+---------+---------+-------------+---------------+----------------+----------+----------+-------------+-------------------+----------------------+
   |           1001 | unit1 | 2025-05-28 11:19:39.116490 | 2025-05-28 11:31:15.005869 |       2 |       2 |  5368709120 |   10737418240 |           NULL |     1280 |     1024 |           1 |           4194304 |                    8 |
   +----------------+-------+----------------------------+----------------------------+---------+---------+-------------+---------------+----------------+----------+----------+-------------+-------------------+----------------------+
   1 row in set
   

関連ドキュメント

テナントとリソース情報の表示