---
title: github-fill
description: enable_standby_read_write_split enable_standby_read_write_split 用于控制通过 Service Name 登录的租户是否开启主备租户读写分离功能。 说明 该配置项自 4.3.3 版本开始引入。 配置修改仅对新建连接生效，对已存在的连接不生效。 属性 描述 …
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*nSAhQbrBXKwAAAAAAAAAAAAADiGDAQ/original) 数据库代理 V 4.3.5

# enable_standby_read_write_split

更新时间：2026-01-09 12:31:43

[编辑](https://github.com/oceanbase/oceanbase-proxy-doc/edit/V4.3.5/zh-CN/400.configuration-management/300.multi-level-configuration-items/830.enable-standby-read-write-split.md)  

`enable_standby_read_write_split` 用于控制通过 Service Name 登录的租户是否开启主备租户读写分离功能。

#### 说明

- 该配置项自 4.3.3 版本开始引入。
 - 配置修改仅对新建连接生效，对已存在的连接不生效。

| 属性 | 描述 |
| --- | --- |
| 参数类型 | 布尔类型 |
| 默认值 | False |
| 取值范围 | - True：开启主备租户读写分离功能 - False：关闭主备租户读写分离功能 |
| 是否重启 ODP 生效 | 否 |

## 示例

配置租户级别时，租户名格式为 `service:xxxx`，集群名为空。此处以开启 `service_name_a` 的主备租户读写分离能力为例，示例如下：

1. 设置 `service_name_a` 的备集群为 `cluster_A`

   ```sql
   replace into proxy_config(cluster_name, tenant_name, name, value, config_level) values ('', 'service:service_name_a', 'rootservice_cluster_name', 'cluster_A', 'LEVEL_TENANT');

   ```

   通过 Service Name 登录时，`rootservice_cluster_name` 配置项用于设置读写分离场景下优先路由的备集群。未配置 `rootservice_cluster_name` 的场景下，开启主备租户读写分离能力后，ODP 默认会将需要发给备租户的请求优先发给缓存中的第一个备租户。
 2. 开启 `service_name_a` 的主备租户读写分离能力

   ```sql
   replace into proxy_config(cluster_name, tenant_name, name, value, config_level) values ('', 'service:service_name_a', 'enable_standby_read_write_split', 'true', 'LEVEL_TENANT');

   ```

## 相关文档

- `rootservice_cluster_name` 配置项的介绍可参见 [rootservice_cluster_name](https://www.oceanbase.com/docs/common-odp-doc-cn-1000000003575571)。
 - Service Name 的相关介绍可参见 [主备租户自动路由](https://www.oceanbase.com/docs/common-odp-doc-cn-1000000003575298)。

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