---
title: "修改资源池属性 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心"
description: 修改资源池属性 修改资源池属性，即是调整资源池配置的 UNIT 、 UNIT_NUM 、 ZONE_LIST 等参数信息。本文介绍如何修改资源池属性。 资源池属性可以通过 ALTER RESOURCE POOL 语句进行修改。 修改租户资源池属性是实现租户扩容或缩容的另一种方式。例如，调大 UNIT_NUM 可以增加…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0

# 修改资源池属性

更新时间：2026-04-30 19:06:39

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/600.manage/200.tenant-management/600.common-tenant-operations/900.modify-resource-pool-properties.md)  

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

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

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

## 操作步骤

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

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

   ```
 2. 进入 `oceanbase` 数据库。

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

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

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

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

   ```

   查询结果如下：

   ```shell
   +------------------+------------+-----------+----------------------------+----------------------------+------------+----------------+-------------+--------------+
   | 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](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005684220)。
 4. 通过 `ALTER RESOURCE POOL` 语句，修改资源池配置。

   #### 注意

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

   语法如下：

   ```sql
   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](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683365)。

       `ALTER RESOURCE TENANT` 语句的详细说明，参见 [ALTER RESOURCE TENANT](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683369)。
      - `ZONE_LIST`：资源池的 Zone 分布。

   示例：

       同构 Zone 模式   异构 Zone 模式
      - 资源池未被分配给租户

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

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

       ```

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

       ```

       ```shell
       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'`。

       ```

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

       ```

       ```

   #### 注意

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

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

   ```

   ```

   ```

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

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

   ```

   查询结果如下：

   ```shell
   +------------------+------------+-----------+----------------------------+----------------------------+------------+----------------+-------------------+--------------+
   | 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

   ```

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线
