修改资源池属性

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

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

修改租户资源池属性是实现租户扩容或缩容的另一种方式。例如，调大 UNIT_NUM 可以增加每个 Zone 中节点数量达到扩容的目的。

操作步骤

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

   obclient -h172.30.xx.xx -P2883 -uroot@sys#cluster -p**** -A
   

2. 进入 oceanbase 数据库。

   obclient(root@sys)[(none)]> USE oceanbase;
   

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

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

   obclient(root@sys)[oceanbase]> SELECT * FROM DBA_OB_RESOURCE_POOLS WHERE NAME = 'mq_pool_02';
   

   查询结果如下：

   +------------------+------------+-----------+----------------------------+----------------------------+------------+----------------+-------------+--------------+
   | RESOURCE_POOL_ID | NAME       | TENANT_ID | CREATE_TIME                | MODIFY_TIME                | UNIT_COUNT | UNIT_CONFIG_ID | ZONE_LIST   | REPLICA_TYPE |
   +------------------+------------+-----------+----------------------------+----------------------------+------------+----------------+-------------+--------------+
   |             1026 | mq_pool_02 |      NULL | 2023-01-10 23:54:24.177685 | 2023-01-10 23:54:24.177685 |          1 |           1020 | zone1;zone2 | 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 的个数。

     注意

     当前版本支持异构 Zone 模式，在修改 UNIT_NUM 时：

     • 同构 Zone 模式下，如果该资源池已经被租户使用，无法通过ALTER RESOURCE POOL 语句进行修改，需要使用 ALTER RESOURCE TENANT 语句进行修改。
     • 异构 Zone 模式下，即使资源池已经被租户使用，也可以通过 ALTER RESOURCE POOL 语句进行修改，但修改时，要求一个租户下多个资源池最多只能有两种不同的 UNIT_NUM。

       例如，一租户有 3 个资源池 pool1、pool2、pool3，其 unit_num 分别为 2、4、4，如果将 pool3 的 unit_num 修改为 1，则系统会报 More than two distinct unit_num in a single tenant not allowed的错误。

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

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

   • ZONE_LIST：资源池的 Zone 分布。

   示例：

   同构 Zone 模式

   异构 Zone 模式

   • 资源池未被分配给租户

     修改资源池 mq_pool_02 的资源规格为 'S2_unit_config'，资源单元个数为 3，ZONE_LIST 为 'zone1','zone2','zone3'。

     obclient(root@sys)[oceanbase]> ALTER RESOURCE POOL mq_pool_02 UNIT='S2_unit_config';
     

     obclient(root@sys)[oceanbase]> ALTER RESOURCE POOL mq_pool_02 UNIT_NUM=3;
     

     obclient(root@sys)[oceanbase]> ALTER RESOURCE POOL mq_pool_02 ZONE_LIST=('zone1','zone2','zone3');
     

   • 资源池已被分配给租户

     同构 Zone 模式下，资源池已分配给租户后，修改租户的资源池配置时，UNIT_NUM 需要通过 ALTER RESOURCE TENANT 语句进行修改。

     修改资源池 mq_pool_02 的资源规格为 'S2_unit_config'，资源单元个数为 3，ZONE_LIST 为 'zone1','zone2','zone3'。

     obclient(root@sys)[oceanbase]> ALTER RESOURCE POOL mq_pool_02 UNIT='S2_unit_config';
     

     obclient(root@sys)[oceanbase]> ALTER RESOURCE TENANT mq_t2 UNIT_NUM=3;
     

     obclient(root@sys)[oceanbase]> ALTER RESOURCE POOL mq_pool_02 ZONE_LIST=('zone1','zone2','zone3');
     

   注意

   通常情况下，对于已有租户或者升级上来的租户，默认均为同构 Zone 模式，如果需要开启异构 Zone 模式，需要将租户级配置项 zone_deploy_mode 的值修改为 hetero（异构 Zone 模式）。修改后，不支持再改回 homo（同构 Zone 模式）。

   分别修改资源池 mq_pool_02 的资源规格为 'S2_unit_config'，资源单元个数为 3，ZONE_LIST 为 'zone1','zone2','zone3'。

   obclient(root@sys)[oceanbase]> ALTER RESOURCE POOL mq_pool_02 UNIT='S2_unit_config';
   

   obclient(root@sys)[oceanbase]> ALTER RESOURCE POOL mq_pool_02 UNIT_NUM=3;
   

   obclient(root@sys)[oceanbase]> ALTER RESOURCE TENANT mq_t2 UNIT_NUM=3;
   

   obclient(root@sys)[oceanbase]> ALTER RESOURCE POOL mq_pool_02 ZONE_LIST=('zone1','zone2','zone3');
   

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

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

   obclient(root@sys)[oceanbase]> SELECT * FROM DBA_OB_RESOURCE_POOLS WHERE NAME = 'mq_pool_02';
   

   查询结果如下：

   +------------------+------------+-----------+----------------------------+----------------------------+------------+----------------+-------------------+--------------+
   | RESOURCE_POOL_ID | NAME       | TENANT_ID | CREATE_TIME                | MODIFY_TIME                | UNIT_COUNT | UNIT_CONFIG_ID | ZONE_LIST         | REPLICA_TYPE |
   +------------------+------------+-----------+----------------------------+----------------------------+------------+----------------+-------------------+--------------+
   |             1026 | mq_pool_02 |      NULL | 2023-01-10 23:54:24.177685 | 2023-01-10 23:56:04.961771 |          2 |           1021 | zone1;zone2;zone3 | FULL         |
   +------------------+------------+-----------+----------------------------+----------------------------+------------+----------------+-------------------+--------------+
   1 row in set