修改资源池属性

修改资源池属性，即是调整资源池配置的 UNIT、UNIT_NUM、ZONE_LIST 等参数信息。本文介绍如何修改资源池属性。

资源池属性可以通过 ALTER RESOURCE POOL 语句进行修改。

操作步骤

1. 使用 root 用户登录到集群的 sys 租户。

   obclient -h172.30.xx.xx -P2881 -uroot@sys -p**** -A
   

2. 进入 oceanbase 数据库。

   obclient [(none)]> USE oceanbase;
   

3. 通过 DBA_OB_RESOURCE_POOLS 视图，获取资源池的配置信息。

   以查询资源池 test_pool 的配置信息为例：

   obclient [oceanbase]> SELECT * FROM DBA_OB_RESOURCE_POOLS WHERE NAME = 'test_pool';
   +------------------+-----------+-----------+----------------------------+----------------------------+------------+----------------+-----------+--------------+
   | RESOURCE_POOL_ID | NAME      | TENANT_ID | CREATE_TIME                | MODIFY_TIME                | UNIT_COUNT | UNIT_CONFIG_ID | ZONE_LIST | REPLICA_TYPE |
   +------------------+-----------+-----------+----------------------------+----------------------------+------------+----------------+-----------+--------------+
   |             1001 | test_pool |      1002 | 2025-03-26 10:31:13.286355 | 2025-03-26 10:31:13.376357 |          1 |           1001 | zone1     | FULL         |
   +------------------+-----------+-----------+----------------------------+----------------------------+------------+----------------+-----------+--------------+
   1 row in set
   

   DBA_OB_RESOURCE_POOLS 视图的详细说明，参见 DBA_OB_RESOURCE_POOLS。

4. 通过 ALTER RESOURCE POOL 语句，修改资源池配置。

   注意

   • 单条语句只能修改一个属性，如果需要同时修改 UNIT、UNIT_NUM、ZONE_LIST 中两条及以上的属性，需要分多条语句执行。
   • 修改 ZONE_LIST 时，每次仅支持添加或删除一个 Zone。

   语法如下：

   ALTER RESOURCE POOL pool_name
       UNIT [=] unit_name,
       UNIT_NUM [=] unit_num,
       ZONE_LIST [=] ('zone' [, 'zone' ...]);
   

   参数说明：

   • pool_name：资源池名称。

   • UNIT：该资源池的资源规格。

   • UNIT_NUM：资源单元个数。增加 Unit 数量时，UNIT_NUM 的值不能大于每个 Zone 内 OBServer 的个数。对于 OceanBase 集中式数据库，该值只能为 1。

     注意

     如果该资源池已经被租户使用，无法通过修改资源池属性的方式修改，需要通过 ALTER RESOURCE TENANT 语句进行修改。

   • ZONE_LIST：资源池的 Zone 分布。对于 OceanBase 集中式数据库，只有一个 Zone。

   ALTER RESOURCE POOL 语句的详细说明，参见 ALTER RESOURCE POOL。

   ALTER RESOURCE TENANT 语句的详细说明，参见 ALTER RESOURCE TENANT。

   注意

   OceanBase 集中式数据库只能修改 UNIT。

   示例：

   修改资源池 test_pool 的资源规格为 'S2_unit_config'。

   obclient [oceanbase]> ALTER RESOURCE POOL test_pool UNIT='S2_unit_config';
   Query OK, 0 rows affected
   

5. 查看 DBA_OB_RESOURCE_POOLS 视图，确认资源池配置修改结果。

   结果如下，可以看到 UNIT_CONFIG_ID 参数已经更新。

   obclient [oceanbase]> SELECT * FROM DBA_OB_RESOURCE_POOLS WHERE NAME = 'test_pool';
   +------------------+-----------+-----------+----------------------------+----------------------------+------------+----------------+-----------+--------------+
   | RESOURCE_POOL_ID | NAME      | TENANT_ID | CREATE_TIME                | MODIFY_TIME                | UNIT_COUNT | UNIT_CONFIG_ID | ZONE_LIST | REPLICA_TYPE |
   +------------------+-----------+-----------+----------------------------+----------------------------+------------+----------------+-----------+--------------+
   |             1001 | test_pool |      1002 | 2025-03-26 10:31:13.286355 | 2025-03-26 20:09:47.882378 |          1 |           1003 | zone1     | FULL         |
   +------------------+-----------+-----------+----------------------------+----------------------------+------------+----------------+-----------+--------------+
   1 row in set