---
title: github-fill
description: enable_transfer 说明 该配置项从 V4.2.1 版本开始引入。 功能描述 enable_transfer 用于控制是否允许在租户内进行 Transfer。关闭配置项 enable_rebalance 时此配置项无效。 属性说明 属性 描述 参数类型 BOOL 默认值 True 取值范围 True：开启…
---
切换语言

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

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

# enable_transfer

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

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

#### 说明

该配置项从 V4.2.1 版本开始引入。

## 功能描述

`enable_transfer` 用于控制是否允许在租户内进行 Transfer。关闭配置项 `enable_rebalance` 时此配置项无效。

## 属性说明

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

## 使用说明

租户内的负载均衡策略由租户级配置项 `enable_rebalance` 和 `enable_transfer` 共同控制。

配置项 `enable_rebalance` 在系统租户下用于控制是否进行租户间的负载均衡；在用户租户下用于控制是否进行租户内均衡。默认值为 `true`，设置后不需要重启 OBServer 节点，立即生效。

配置项 `enable_transfer` 用于控制是否开启租户下的 Transfer 功能，默认值为 `true`，设置后不需要重启 OBServer 节点，立即生效。配置项 `enable_transfer` 值的含义依赖配置项 `enable_rebalance` 的取值：

- 当配置项 `enable_rebalance` 的值为 `false` 时，无论配置项 `enable_transfer` 的值为 `true` 还是 `false`，系统均不会进行自动负载均衡。关闭所有负载均衡的命令如下：

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

  ```
 - 当配置项 `enable_rebalance` 的值为 `true` 且 `enable_transfer` 的值为 `true` 时，表示在进行租户扩缩容操作时，系统会自动调整分区分布，实现负载均衡。根据负载均衡算法动态调整租户日志流数量，自动进行租户下的 Leader 均衡和分区均衡的命令如下：

  ```shell
  obclient> ALTER SYSTEM SET enable_rebalance=true;
  obclient> ALTER SYSTEM SET enable_transfer=true;

  ```
 - 当配置项 `enable_rebalance` 的值为 `true` 且 `enable_transfer` 的值为 `false` 时，表示在进行租户扩缩容操作时，系统不能发起 Transfer 操作，只能通过日志流迁移实现有限的均衡。只在现有日志流基础上进行日志流均衡，不产生 Transfer 和日志流数量动态变化的命令如下：

  ```shell
  obclient> ALTER SYSTEM SET enable_rebalance=true;
  obclient> ALTER SYSTEM SET enable_transfer=false;

  ```

## 配置示例

- 系统租户设置指定租户的负载均衡策略

     - 系统租户开启指定租户的租户内负载均衡和租户下的 Transfer 功能

      ```shell
      obclient> ALTER SYSTEM SET enable_rebalance = true TENANT = 'tenant_name';

      ```

      ```shell
      obclient> ALTER SYSTEM SET enable_transfer = true TENANT = 'tenant_name';

      ```

      以上语句表示仅指定租户下的配置项 `enable_rebalance` 和 `enable_transfer` 的值为 `true`。
     - 系统租户开启所有用户租户（不含 `sys` 租户和 Meta 租户）的租户内负载均衡和租户下的 Transfer 功能

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

      ```

      ```shell
      obclient> ALTER SYSTEM SET enable_transfer = true TENANT = all_user;

      ```

      或者

      ```shell
      obclient> ALTER SYSTEM SET enable_rebalance = true TENANT = all;

      ```

      ```shell
      obclient> ALTER SYSTEM SET enable_transfer = true TENANT = all;

      ```

      以上语句表示所有用户租户下配置项 `enable_rebalance` 和 `enable_transfer` 的值为 `true`。

      #### 说明

      OceanBase 数据库从 V4.2.1 版本开始，`TENANT = all_user` 与 `TENANT = all`语义相同，在需要生效范围为所有用户租户时，推荐使用 `TENANT = all_user`，后续 `TENANT = all` 将废弃不再使用。
 - 用户租户设置本租户的负载均衡策略

      MySQL 模式   Oracle 模式

  MySQL 租户开启本租户的租户内负载均衡和租户下的 Transfer 功能的语句如下：

  ```shell
  obclient> ALTER SYSTEM SET enable_rebalance = true;

  ```

  ```shell
  obclient> ALTER SYSTEM SET enable_transfer = true;

  ```

  Oracle 租户开启本租户的租户内负载均衡和租户下的 Transfer 功能的语句如下：

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

  ```

  ```shell
  obclient> ALTER SYSTEM SET enable_transfer = 'true';

  ```

## 相关文档

- [通过调整 Unit Number 实现租户扩缩容](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000819172)
 - [通过调整 Primary Zone 实现租户扩缩容](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000819173)
 - [enable_rebalance](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000820916)

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