説明
ALTER RESOURCE UNIT 文は、Unitのリソース構成を変更するために使用します。リソース構成の変更とは、主にCPU、メモリ、ログディスク容量などを増減することです。
使用上の制限と注意事項
リソース構成を変更する前に、そのリソース構成に対応するUnitがテナントによって使用されている場合は、以下の点に注意してください:
リソース構成を増やす場合は、Unitが配置されている各ノードに割り当て可能な十分な余剰リソースがあることを確保する必要があります。
ビュー
GV$OB_SERVERSをクエリすることで、各ノードの総リソースおよび既に割り当てられているリソースを確認できます。詳細な操作については、テナントとリソース情報の確認を参照してください。リソース構成を減らす場合は、変更後のCPU、メモリ、ログディスク容量などのリソース総量が、現在のテナントが既に使用しているリソース総量以上であることを確保する必要があります。
権限要件
Unitのリソース構成を変更できるのは、sysテナントのrootユーザー(root@sys)のみです。他のテナントではUnitのリソース構成の変更はサポートされません。
文
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,]
[DATA_DISK_SIZE [=] 'size_value',]
[LOG_DISK_SIZE [=] 'size_value'];
パラメータの説明
パラメータ |
説明 |
|---|---|
| unit_name | 変更対象のリソース構成を持つUnitの名前を指定します。 |
| MEMORY_SIZE | メモリ構成を変更します。最小値は隠れたパラメータ__min_full_resource_pool_memoryによって制御され、デフォルトは5Gです。安定性を確保するため、最小メモリ構成は4Gを推奨します。
注意OceanBaseデータベースはV4.0.0.0以降、メモリオーバーコミットをサポートしていません。 |
| MAX_CPU | CPU構成の上限を変更します。最小値は1で、1コアを表します。この値は現在のMIN_CPUの値以上である必要があります。 |
| MIN_CPU | CPU構成の下限を変更します。選択可能です。最小値は1で、1コアを表します。この値は現在のMAX_CPUの値以下である必要があります。 |
| MAX_IOPS | IOPSの上限を変更します。選択可能です。最小値は1024で、この値はMIN_IOPSの値以上である必要があります。 |
| MIN_IOPS | IOPSの下限を変更します。選択可能です。最小値は1024で、この値はMAX_IOPSの値以下である必要があります。 |
| MAX_NET_BANDWIDTH | テナントの各Unitが使用できるネットワーク帯域幅の上限を変更します。最小値は1Mです。 |
| NET_BANDWIDTH_WEIGHT | テナントUnitのネットワーク帯域幅重みを変更します。これは、各OBServerの帯域幅を各テナントに割り当てる比率を計算するために使用されます。最小値は0です。 |
| DATA_DISK_SIZE | テナントの各Unitが使用できるローカルディスク容量を変更します。共有ストレージ(Shared-Storage,SS)モードでのみ適用されます。共有なし(Shared-Nothing, SN)モードでは、この仕様を変更するとエラーが発生します。SSモードでは、この仕様を変更する場合:
説明SSモードでは、テナントの作成、Unitの移行、または拡張時に、システムはUnitの |
| LOG_DISK_SIZE | ログディスクのサイズを変更します。選択可能です。デフォルト値はメモリ構成値の3倍、最小値は2Gです。 |
例
リソースユニット
unit1のリソース仕様を確認します。obclient(root@sys)[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リソースユニット
unit1のリソース仕様を変更します。CPUを2コア、メモリを5GBに設定し、各Unitが使用できる最大ネットワーク帯域幅を4MB、ネットワーク帯域幅の重みを8に設定します。obclient(root@sys)[oceanbase]> ALTER RESOURCE UNIT unit1 MAX_CPU 2, MIN_CPU 2, MEMORY_SIZE '5G', MAX_NET_BANDWIDTH '4M', NET_BANDWIDTH_WEIGHT 8;変更後、再度リソースユニット
unit1のリソース仕様を確認します。obclient(root@sys)[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