---
title: "enable_check_cluster_name - 数据库代理  V4.3.5 | OceanBase 文档中心"
description: enable_check_cluster_name enable_check_cluster_name 用于控制三段式登录时是否校验集群名。配置为 True 时，会校验集群名是否等于默认集群名（由 rootservice_cluster_name 配置），校验失败将拒绝登录。 说明 该配置项自 4.3.3 版本开始引…
---
切换语言

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

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

# enable_check_cluster_name

更新时间：2025-11-21 13:51:01

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

`enable_check_cluster_name` 用于控制三段式登录时是否校验集群名。配置为 `True` 时，会校验集群名是否等于默认集群名（由 `rootservice_cluster_name` 配置），校验失败将拒绝登录。

#### 说明

- 该配置项自 4.3.3 版本开始引入。
 - 三段式登录表示通过配置用户名、租户名、集群名的方式登录，如 `root@sys#obdemo`。

| 属性 | 描述 |
| --- | --- |
| 参数类型 | 布尔类型 |
| 默认值 | False |
| 取值范围 | - True：校验集群名 - False：不校验集群名 |
| 是否重启 ODP 生效 | 否 |

## 示例

此处假设 `obdemo` 集群中存在 `test1`、`test2` 租户，以设置登录 `test1` 租户时校验集群名，登录 `test2` 租户时不校验集群名为例，示例如下：

```shell
obclient [(none)]> replace into proxy_config(tenant_name, cluster_name, name, value, config_level) values
    ('test1','obdemo','enable_check_cluster_name','True','LEVEL_TENANT'),
    ('test2','obdemo','enable_check_cluster_name','False','LEVEL_TENANT');

```

## 相关文档

[rootservice_cluster_name](https://www.oceanbase.com/docs/common-odp-doc-cn-1000000003575571)

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