--- title: "Locality 介绍 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心" description: Locality 介绍 为了描述数据的多个副本的类型及分布策略，我们引入了 Locality 的概念。OceanBase 数据库当前版本仅支持租户级别的 Locality，不再支持表级、DB 级、Table Group 级配置 Locality。 副本指的是数据，而 Locality 描述的对象是承载数据的容器，从而… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0 # Locality 介绍 更新时间：2026-05-28 12:14:37 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/600.manage/300.replica-management/200.replica-distribution/100.locality-overview.md) 为了描述数据的多个副本的类型及分布策略，我们引入了 Locality 的概念。OceanBase 数据库当前版本仅支持租户级别的 Locality，不再支持表级、DB 级、Table Group 级配置 Locality。 副本指的是数据，而 Locality 描述的对象是承载数据的容器，从而该容器下的数据具有容器的 Locality 属性所描述的类型及分布策略。 OceanBase 数据库当前版本仅支持租户级别的 Locality，而 OceanBase 数据库 V3.x 还支持表级、DB 级、Table Group 级配置 Locality。 ## Locality 语法 Locality 的语法结构如下所示： ```sql replicas{量词}@location ``` 语法中各元素的意义如下表所示： | **元素** | **说明** | | --- | --- | | replicas | 表示副本类型。replicas 的值为副本名称，可以在 [副本介绍](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682017) 中的副本类型说明表中的名称列获得支持的值（支持全名和简写）。 | | location | 表示位置。它是系统已知的一组枚举值。location 的值为 Zone 的名称。集群和租户中的各 Zone 的名称可以通过 `oceanbase.DBA_OB_ZONES` 视图查询。 有关 `DBA_OB_ZONES` 视图的详细信息，请参见 [oceanbase.DBA_OB_ZONES](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005684212)。 | | 量词 | 固定为 1，表示一个副本。也可以不指定。 | 租户的 Locality 属性可以通过系统租户下 `oceanbase.DBA_OB_TENANTS` 视图的 `LOCALITY` 字段查看。示例如下： ```shell obclient(root@sys)[oceanbase]> SELECT TENANT_ID, TENANT_NAME, TENANT_TYPE, CREATE_TIME, PRIMARY_ZONE, LOCALITY, COMPATIBILITY_MODE, STATUS FROM oceanbase.DBA_OB_TENANTS; ``` 查询结果如下： ```shell +-----------+-------------+-------------+----------------------------+--------------+----------------------------------------------+--------------------+--------+ | TENANT_ID | TENANT_NAME | TENANT_TYPE | CREATE_TIME | PRIMARY_ZONE | LOCALITY | COMPATIBILITY_MODE | STATUS | +-----------+-------------+-------------+----------------------------+--------------+----------------------------------------------+--------------------+--------+ | 1 | sys | SYS | 2025-12-29 15:43:42.930290 | RANDOM | FULL{1}@zone1 | MYSQL | NORMAL | | 1001 | META$1002 | META | 2025-12-29 15:44:48.700796 | zone1;zone2 | FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone3 | MYSQL | NORMAL | | 1002 | mysql001 | USER | 2025-12-29 15:44:48.704354 | zone1;zone2 | FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone3 | MYSQL | NORMAL | | 1003 | META$1004 | META | 2025-12-29 15:50:35.033311 | zone1 | FULL{1}@zone1 | MYSQL | NORMAL | | 1004 | oracle001 | USER | 2025-12-29 15:50:35.034367 | zone1 | FULL{1}@zone1 | ORACLE | NORMAL | +-----------+-------------+-------------+----------------------------+--------------+----------------------------------------------+--------------------+--------+ 5 rows in set ``` ## 示例 下述示例展示了在一个拥有五个 Zone（z1~z5）的 OceanBase 集群中，可以容纳不同 Locality 的多个租户和它们的 Locality 情况： - sys tenant 的 Locality：`F@z1,F@z2,F@z3,F@z4,F@z5`。 表示系统租户在 `z1,z2,z3,z4,z5` 上各存在一个全能型副本。 - tenant1 的 Locality：`F@z1,F@z2,F@z3`。 表示租户 tenant1 在 `z1,z2,z3` 上各存在一个全能型副本。 - tenant2 的 Locality：`F@z3,F@z4,F@z5`。 表示租户 tenant2 在 `z3,z4,z5` 上存在一个全能型副本。 如图所示： ![locality](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.2.1/manage/locality.jpg) ## Locality 属性与高可用架构 多副本架构是 OceanBase 数据库相比于传统数据库的架构优势，多副本架构是 OceanBase 数据库具备多级无损容灾能力的基础，包括单机级无损容灾、机房级无损容灾、城市级无损容灾等能力。OceanBase 数据库支持灵活的调整集群部署架构，从而可以满足业务场景的技术演进。 OceanBase 数据库的灵活的部署架构正是通过 Locality 属性体现的，Locality 除了描述副本类型，还描述了副本在 Zone 间的分布策略。Zone 具有 Region 属性，可通过 `oceanbase.DBA_OB_ZONES` 视图的 `REGION` 字段查看，描述了该 Zone 的地域分布。通过调整租户的多个副本在不同 Region 的 不同 Zone 间的分布，从而达到灵活的部署模式。 OceanBase 数据库典型的部署模式有三种，分别是同城三中心、两地三中心、三地五中心，其 Locality 属性举例如下： | 部署模式 | Locality 属性 | Zone 分布 | | --- | --- | --- | | 同城三中心 | `F@z1,F@z2,F@z3` | z1、z2、z3 分别位于 Region R1 的 IDC idc1、idc2、idc3 | | 两地三中心 | `F@z1,F@z2,F@z3,F@z4,F@z5` | z1、z2 位于 Region R1 的 IDC idc1； z3、z4 位于 Region R1 的 IDC idc2； z5 位于 Region R2 | | 三地五中心 | `F@z1,F@z2,F@z3,F@z4,F@z5` | z1、z2 位于 Region R1 的 IDC idc1 和 IDC idc2； z3、z4 位于 Region R2 的 IDC idc3 和 IDC idc4； z5 位于 Region R3 | 上一篇 下一篇 ![有帮助](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) 咨询热线