---
title: "enable_rebalance - OceanBase 数据库 V4.3.0 | OceanBase 文档中心"
description: enable_rebalance 说明 该配置项从 V1.4 版本开始引入。 该配置项从 V4.2.0 版本开始级别由集群级调整为租户级。 功能描述 enable_rebalance 用于设置是否开启自动负载均衡的功能。 不同租户下的配置项控制不同的均衡操作： 系统租户下用于控制是否进行租户间均衡。 false：不会…
---
切换语言

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

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

# enable_rebalance

更新时间：2026-04-10 11:58:36

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.0/zh-CN/700.reference/800.configuration-items-and-system-variables/100.system-configuration-items/400.tenant-level-configuration-items/6700.enable_rebalance.md)

#### 说明

- 该配置项从 V1.4 版本开始引入。
 - 该配置项从 V4.2.0 版本开始级别由集群级调整为租户级。

## 功能描述

`enable_rebalance` 用于设置是否开启自动负载均衡的功能。

不同租户下的配置项控制不同的均衡操作：

- 系统租户下用于控制是否进行租户间均衡。

     - false：不会进行后台的 Unit 迁移操作，但是在节点永久下线或者处于 DELETING 状态时，Unit 迁移不受配置项控制。
     - true：可以通过 Unit 迁移达到均衡态。
 - 用户租户下用于控制是否进行租户内均衡。

     - false：租户内不在进行负载均衡操作，已经在进行中的均衡操作会取消。若此时发起扩缩容操作将会报错，例如进行以下操作时：
           - 租户的 Unit Number 增大或缩小。
           - 第一优先级的 Primary Zone 发生变化，如果第一优先级的 Primary Zone 不发生变化，则不会报错。
           - Primary Zone 为 RANDOM 的情况下，F 副本个数发生变化。
     - true ：租户内可以执行负载均衡操作。

#### 说明

- 如果您想要实现租户间的负载均衡，需要将系统租户下的 `enable_rebalance` 配置项设置为 True。关闭该配置项可以确保不进行租户间的均衡操作。
 - 如果您希望对租户进行扩缩容操作或使用租户分区的自动均衡能力，则需要在租户下打开 `enable_rebalance` 配置项，以实现自动负载均衡和分区迁移。相反，关闭该配置项将停止租户内的自动均衡操作。

## 权限要求

- 查询配置项

  `sys` 租户和所有用户租户均可以使用 `SHOW PARAMETERS` 语句或视图 `GV$OB_PARAMETERS` 查询该配置项。
 - 修改配置项

  `sys` 租户和用户租户均可修改该配置项。

## 属性说明

| **属性** | **描述** |
| --- | --- |
| 参数类型 | BOOL |
| 默认值 | True |
| 取值范围 | - True：开启 - False：不开启 |
| 是否可修改 | 是，支持通过 `ALTER SYSTEM SET` 语句修改。 |
| 是否重启 OBServer 节点生效 | 否 |

## 配置示例

- 租户间均衡与租户内均衡都关闭。

  ```shell
  obclient> ALTER SYSTEM SET enable_rebalance = false tenant = all_user;

  ```
 - 只开启租户间均衡。

  ```shell
  obclient> ALTER SYSTEM SET enable_rebalance = true tenant='all_user';

  ```
 - 关闭租户间均衡，可以进行租户内均衡。

  ```shell
  obclient> ALTER SYSTEM SET enable_rebalance = false tenant='all_user';
            ALTER SYSTEM SET enable_rebalance = true tenant='MYSQL';

  ```

## 相关文档

- [通过调整 Unit Number 实现租户扩缩容](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000640378)
 - [通过调整 Primary Zone 实现租户扩缩容](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000640379)
 - [资源单元的均衡](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000640596)
 - [enable_transfer](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000642060)

 上一篇 下一篇 ![有帮助](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) 咨询热线