在集群中增加 Zone | OceanBase 文档中心

在集群中增加 Zone

更新时间：2026-06-25 11:01:16

本节主要介绍如何通过在集群中增加 Zone 的方式进行集群的扩容。

通过 SQL 语句在集群中增加 Zone

您可以通过 SQL 语句向集群中增加 Zone 的方式来进行集群的扩容。该扩容方式通常用于将集群中租户的 3 副本升级为 5 副本的场景。在集群中增加 Zone，同时为新增的 Zone 添加与其他 Zone 等量的物理机台数。

假设集群中当前仅有 z1、z2、z3 三个 Zone，且三个 Zone 都属于同一个 Region，每个 Zone 内一台 OBServer。集群中有一个普通租户 tenant1，当前副本分布情况 locality='F@z1,F@z2,F@z3', resource_pool_list=('pool1');，根据业务需要，需要将租户 tenant1 由 3 副本调整为 5 副本，即租户的 Locality 由 F@z1,F@z2,F@z3 变为 F@z1,F@z2,F@z3,F@z4,F@z5。

在集群中增加 Zone 并调整副本分布的操作如下：

使用 root 用户登录到数据库的 sys 租户。
集群中当前仅 z1、z2、z3 三个 Zone，需要在集群中增加 z4、z5 两个 Zone。

在集群中增加 Zone 的具体操作请参见增加或删除 Zone。
在 z4、z5 两个 Zone 上各添加一台 OBServer。

向 Zone 内添加 OBServer 的具体操作请参见添加 OBServer。

为租户 tenant1 在 z4、z5 上添加资源。

创建可用的资源单元和资源池。

obclient>CREATE RESOURCE UNIT unit2 MAX_CPU 1, MAX_MEMORY '5G', MAX_IOPS 128,MAX_DISK_SIZE '10G', MAX_SESSION_NUM 64, MIN_CPU=1, MIN_MEMORY='5G', MIN_IOPS=128;

obclient>CREATE RESOURCE POOL pool2 unit = 'unit2', unit_num = 1, zone_list=('z4','z5');

完成后，为租户在 z4、z5 上添加资源。

obclient>ALTER TENANT tenant1 RESOURCE_POOL_LIST =('pool1', 'pool2') ;

通过修改租户的 Locality 来增加副本。

根据 Locality 的变更规则，每次只能增加一个 Zone 内的 Locality，Locality 的变更规则相关信息请参见 Locality 概述。
```
obclient>ALTER TENANT tenant1 LOCALITY='F@z1,F@z2,F@z3,F@z4';

obclient>ALTER TENANT tenant1 LOCALITY='F@z1,F@z2,F@z3,F@z4,F@z5';
```
操作结束后，本次扩容完成。

通过 OCP 在集群中增加 Zone

您可以通过 OCP 向集群中增加 Zone 的方式来进行集群的扩容。该扩容方式通常用于将集群中租户的 3 副本升级为 5 副本的场景。在集群中增加 Zone，同时为新增的 Zone 添加与其他 Zone 等量的物理机台数。

前提条件

在扩容前，需要先添加主机。添加主机操作用于将线下设备添加到 OCP 控制台中，可用于后续的扩容、替换以及新集群的搭建。说明

为避免将不支持的主机添加到 OCP 中，在添加主机前，请确认机器规格、操作系统均符合 OceanBase 数据库当前版本《部署指南》文档中的要求，并已参考当前版本的《部署指南》文档安装了依赖的软件包。

添加主机的操作如下，请根据实际扩容情况，依次添加多台主机。

登录 OCP。
在左侧导航栏中单击主机。
在页面右上角单击 添加主机 。
填写 IP 地址 和 SSH 端口号 。输入新主机的 IPv4 地址，SSH端口号默认 22。
选择机型。如果没有对应的机型，可以单击新增机型，立即在 OCP 中新增机型。

机型是用户为配置相同的主机指定的一个标签，建议用户指定有意义的名称，便于更好地管理主机。
选择机房。如果没有对应的机房，可以单击新增机房，立即在 OCP 中新增机房。
- 区域用于表示主机所处的地理区域，一个物理区域下可以存在一个或多个物理机房。
- 区域和机房是 OceanBase 负载均衡和 SQL 语句路由策略的参考项，请按照实际情况填写。
说明

OCP V3.1.1 版本开始支持多 AZone 模式，新增机房时，将在当前 OCP 所在的 AZone 中创建新的机房。

在 选择凭据 列表中选择主机的登录凭据。

1728

参数	说明
凭据名	以英文字母开头、英文或数字结尾，可包含英文、数字和下划线，且长度为 2 ~ 32
授权类型	包含用户名/密码和 SSH 私钥两种方式。
用户类型	包含 root 用户和普通用户两种类型，当选择普通用户，普通用户需要有 sudo 命令权限，并且配置了 sudo 免密功能。

（可选）填写主机说明。
单击确定。

背景信息

假设当前集群中共包含 3 个可用区 z1、z2、z3，每个 Zone 内包含 1 台 OBServer。现在希望将某个租户的 3 副本升级为 5 副本，需要为集群添加 2 个 Zone，且新增的每个 Zone 内均包含 1 台 OBServer，同时还需要为新增的 Zone 增加副本。

操作步骤

登录 OCP。
向集群中增加 2 个 Zone 同时在 Zone 内各添加 1 台 OBServer。

通过 OCP 向集群中增加 Zone 的相关操作请参见增加或删除 Zone。
添加成功后，在租户内，依次为新增的 2 个 Zone 新增副本。

通过 OCP 新增副本的相关操作请参见新增副本。

操作结束后，本次扩容完成。