enable_transfer

功能描述

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

属性说明

使用说明

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

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

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

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

  obclient> ALTER SYSTEM SET enable_rebalance=false;
  

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

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

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

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

配置示例

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

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

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

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

    以上语句表示仅指定租户下的配置项 enable_rebalance 和 enable_transfer 的值为 true。

  • 系统租户开启所有用户租户（不含 sys 租户和 Meta 租户）的租户内负载均衡和租户下的 Transfer 功能

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

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

    或者

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

    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 功能的语句如下：

  obclient> ALTER SYSTEM SET enable_rebalance = true;
  

  obclient> ALTER SYSTEM SET enable_transfer = true;
  

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

  obclient> ALTER SYSTEM SET enable_rebalance = 'true';
  

  obclient> ALTER SYSTEM SET enable_transfer = 'true';
  

相关文档

• 通过调整 Unit Number 实现租户扩缩容
• 通过调整 Primary Zone 实现租户扩缩容
• enable_rebalance