修改租户的 Locality

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

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

• 租户的 Locality 不可以为空。

• 当租户的 Locality 发生变更时，在该租户下，所有 Locality 为空的表的副本的分布情况也会随之变化。Locality 不为空的表在租户的 Locality 变更时，其对应副本的分布情况不会改变。

• 在旧的一轮租户 Locality 没有完成变更时，新一轮的租户 Locality 变更不允许被执行。

说明

更多 Locality 的使用规则，参见 Locality 概述。

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

有关 Zone 上资源单元和资源池的状态的检查方法，请参见 查看集群的资源信息。

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

ALTER TENANT 'TENANT_NAME' SET LOCALITY = 'locality_description'

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

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