---
title: "修改租户的 Locality | OceanBase 文档中心"
description: 修改租户的 Locality OceanBase 数据库支持修改租户级的 Locality。 关于租户的 Locality，需要注意以下规则： 租户的 Locality 不可以为空。 当租户的 Locality 发生变更时，在该租户下，所有 Locality 为空的表的副本的分布情况也会随之变化。Locality 不…
---
切换语言

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

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

# 修改租户的 Locality

更新时间：2023-07-19 13:03:06

OceanBase 数据库支持修改租户级的 Locality。

关于租户的 Locality，需要注意以下规则：

- 租户的 Locality 不可以为空。
 - 当租户的 Locality 发生变更时，在该租户下，所有 Locality 为空的表的副本的分布情况也会随之变化。Locality 不为空的表在租户的 Locality 变更时，其对应副本的分布情况不会改变。
 - 在旧的一轮租户 Locality 没有完成变更时，新一轮的租户 Locality 变更不允许被执行。

> **说明**
>
>  
>
> 更多 Locality 的使用规则，参见 [Locality 概述](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000355095)。

变更 Locality 之前，需要确认待变更的 Zone 上资源单元和资源池的状态。如果 Zone 上的 OBServer 资源不足导致无法存放租户需要的资源单元，则将导致无法进行 Locality 变更。

有关 Zone 上资源单元和资源池的状态的检查方法，请参见 [查看集群的资源信息](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000355577)。

修改租户的 Locality 的语法如下：

```sql
ALTER TENANT 'TENANT_NAME' SET LOCALITY = 'locality_description'

```

将租户 test_tenant 的 Locality 修改为 `F{1}@z1,F{1}@z2,F{1}@z3,F{1}@z4` 的示例如下：

```sql
obclient> ALTER TENANT test_tenant SET LOCALITY = 'F{1}@z1,F{1}@z2,F{1}@z3,F{1}@z4';

```

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