--- title: "Locality 介绍 - OceanBase AI 数据库 V4.6.2 | OceanBase 文档中心" description: Locality 介绍 为了描述数据的多个副本的类型及分布策略，我们引入了 Locality 的概念。OceanBase AI 数据库当前仅支持租户级别的 Locality。 副本指的是数据，而 Locality 描述的对象是承载数据的容器，从而该容器下的数据具有容器的 Locality 属性所描述的类型及分布策略。… image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*w3cwQYKZAJwAAAAAHhAAAAgAeiGDAQ/original) OceanBase AI 数据库V 4.6.2 # Locality 介绍 更新时间：2026-09-02 16:58:40 [编辑](https://github.com/oceanbase/oceanbase-database-ai/edit/V4.6.2/zh-CN/600.manage/300.replica-management/200.replica-distribution/100.locality-overview.md) 为了描述数据的多个副本的类型及分布策略，我们引入了 Locality 的概念。OceanBase AI 数据库当前仅支持租户级别的 Locality。 副本指的是数据，而 Locality 描述的对象是承载数据的容器，从而该容器下的数据具有容器的 Locality 属性所描述的类型及分布策略。 ## Locality 语法 Locality 的语法结构如下所示： ```sql replicas{量词}@location ``` 语法中各元素的意义如下表所示： | **元素** | **说明** | | --- | --- | | replicas | 表示副本类型。replicas 的值为副本名称，可以在 [副本介绍](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006858225) 中的副本类型说明表中的名称列获得支持的值（支持全名和简写）。OceanBase AI 数据库当前仅支持全能副本（F 副本）。 | | location | 表示位置。它是系统已知的一组枚举值。location 的值为 Zone 的名称。集群和租户中的各 Zone 的名称可以通过 `oceanbase.DBA_OB_ZONES` 视图查询。 有关 `DBA_OB_ZONES` 视图的详细信息，请参见 [oceanbase.DBA_OB_ZONES](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006780043)。 | | 量词 | 固定为 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 | MYSQL | NORMAL | | 1002 | mysql001 | USER | 2025-12-29 15:44:48.704354 | zone1;zone2 | FULL{1}@zone1, FULL{1}@zone2 | MYSQL | NORMAL | +-----------+-------------+-------------+----------------------------+--------------+----------------------------------------------+--------------------+--------+ 3 rows in set ``` ## 示例 下述示例展示了在一个拥有两个 Zone（z1、z2）的 OceanBase AI 数据库集群中，可以容纳不同 Locality 的多个租户和它们的 Locality 情况： - sys tenant 的 Locality：`F@z1,F@z2`。 表示系统租户在 `z1,z2` 上各存在一个全能型副本。 - tenant1 的 Locality：`F@z1`。 表示租户 tenant1 在 `z1` 上存在一个全能型副本。 如图所示： ![locality](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oceanbase-database-ai/manage/replica/locality.jpg) ## Locality 属性与高可用架构 多副本架构是 OceanBase AI 数据库相比于传统数据库的架构优势，多副本架构是 OceanBase AI 数据库具备多级无损容灾能力的基础，包括同城单机房部署（计算节点两副本，日志服务三副本）、同城单机房（计算节点单副本，日志服务三副本）、同城多机房部署（计算节点两副本，日志服务三副本）、同城三机房部署（日志服务三副本）等能力。OceanBase AI 数据库支持灵活的调整集群部署架构，从而可以满足业务场景的技术演进。 OceanBase AI 数据库的灵活的部署架构正是通过 Locality 属性体现的，Locality 除了描述副本类型，还描述了副本在 Zone 间的分布策略。Zone 具有 Region 属性，可通过 `oceanbase.DBA_OB_ZONES` 视图的 `REGION` 字段查看，描述了该 Zone 的地域分布。通过调整租户的多个副本在不同 Region 的 不同 Zone 间的分布，从而达到灵活的部署模式。 OceanBase AI 数据库典型的计算节点部署模式有两种，分别是单副本、两副本，其 Locality 属性举例如下： | 部署模式 | Locality 属性 | Zone 分布 | | --- | --- | --- | | 单副本 | `F@z1` | z1 位于 Region R1 的 IDC idc1 | | 两副本 | `F@z1,F@z2` | z1、z2 位于 Region R1 的 IDC idc1 | 上一篇 下一篇 ![有帮助](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) 咨询热线