---
title: "rootservice_cluster_name - 数据库代理  V4.3.5 | OceanBase 文档中心"
description: rootservice_cluster_name 根据登录方式的不同， rootservice_cluster_name 配置项有如下几种作用： 通过 Service Name 登录时，该配置项表示读写分离下的默认备集群。未配置的场景下，开启主备租户读写分离能力后，ODP 默认会将需要发给备租户的请求优先发给缓存中的…
---
切换语言

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

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

# rootservice_cluster_name

更新时间：2025-11-27 10:50:20

[编辑](https://github.com/oceanbase/oceanbase-proxy-doc/edit/V4.3.5/zh-CN/400.configuration-management/300.multi-level-configuration-items/2020.rootservice_cluster_name.md)  

根据登录方式的不同，`rootservice_cluster_name` 配置项有如下几种作用：

- 通过 Service Name 登录时，该配置项表示读写分离下的默认备集群。未配置的场景下，开启主备租户读写分离能力后，ODP 默认会将需要发给备租户的请求优先发给缓存中的第一个备租户。
 - 非 Service Name 登录时，该配置项用于设置 `rootservice_list` 的默认集群名，或云用户的默认集群名。

#### 说明

该配置项自 ODP 4.3.3 版本起更新，区分是否通过 Service Name 登录，通过 Service Name 登陆时，该配置项表示读写分离下的默认备集群。

| 属性 | 描述 |
| --- | --- |
| 参数类型 | 字符串类型 |
| 默认值 | undefined |
| 取值范围 | 不涉及 |
| 是否重启 ODP 生效 | 是 |

## 相关文档

- `rootservice_list` 的详细介绍可参见 [rootservice_list](https://www.oceanbase.com/docs/common-odp-doc-cn-1000000003575454)。
 - 开启主备租户读写分离能力的配置项介绍可参见 [enable_standby_read_write_split](https://www.oceanbase.com/docs/common-odp-doc-cn-1000000003575573)。
 - 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) 咨询热线