---
title: "添加 Zone - OceanBase 数据库 V4.3.0 | OceanBase 文档中心"
description: "添加 Zone 添加 Zone 通常用于集群的扩容场景中。 操作步骤 使用 root 用户登录到集群的 sys 租户。 连接示例如下，连接数据库时请以实际环境为准。 obclient -h10.xx.xx.xx -P2883 -uroot@sys#obdemo -p***** -A 有关更加详细的连接数据库的操作指引…"
---
切换语言

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

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

# 添加 Zone

更新时间：2026-04-10 11:58:35

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.0/zh-CN/600.manage/100.cluster-management/300.common-cluster-operations/800.add-a-zone.md)  

添加 Zone 通常用于集群的扩容场景中。

## 操作步骤

1. 使用 `root` 用户登录到集群的 `sys` 租户。

   连接示例如下，连接数据库时请以实际环境为准。

   ```shell
   obclient -h10.xx.xx.xx -P2883 -uroot@sys#obdemo -p***** -A

   ```

   有关更加详细的连接数据库的操作指引，参见 [连接数据库概述（MySQL 模式）](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000640069) 和 [连接数据库概述（Oracle 模式）](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000640028)。
 2. 执行以下命令，在集群中添加 Zone。

   语句如下：

   ```shell
   obclient [(none)]> ALTER SYSTEM ADD ZONE zone_name [IDC [=] 'idc_name', REGION [=] 'region_name', ZONE_TYPE [=] 'ReadWrite'];

   ```

   相关参数说明如下：

      - `zone_name`：待添加的 Zone 的名称，每条语句每次仅支持添加一个 Zone。如果需要添加多个 Zone，需要重复执行该语句。
      - `idc_name`：指定 Zone 所在机房的名称。如果不指定，默认为空。
      - `region_name`：指定 Zone 所在 Region 的名称，如果不指定，默认值为 `default_region`。
      - `ZONE_TYPE`：指定 Zone 的类型，当前版本仅支持读写 Zone（`ReadWrite`）。如果不指定，默认为读写 Zone。

   在集群中增加 `zone4` 的示例如下：

   ```shell
   obclient [(none)]> ALTER SYSTEM ADD ZONE zone4 IDC 'hz1', REGION 'hangzhou';

   ```
 3. 操作成功后，可以查询 `oceanbase.DBA_OB_ZONES` 视图进行确认。

   ```shell
   obclient [(none)]> SELECT * FROM oceanbase.DBA_OB_ZONES;
   +-------+----------------------------+----------------------------+----------+-----+----------+-----------+
   | ZONE  | CREATE_TIME                | MODIFY_TIME                | STATUS   | IDC | REGION   | TYPE      |
   +-------+----------------------------+----------------------------+----------+-----+----------+-----------+
   | zone1 | 2022-12-20 17:50:17.168745 | 2022-12-20 17:50:40.801054 | ACTIVE   | HZ0 | hangzhou | ReadWrite |
   | zone2 | 2022-12-20 17:50:17.168745 | 2022-12-20 17:50:40.809504 | ACTIVE   | HZ0 | hangzhou | ReadWrite |
   | zone3 | 2022-12-20 17:50:17.169804 | 2022-12-20 17:50:40.815833 | ACTIVE   | SH0 | shanghai | ReadWrite |
   | zone4 | 2023-01-06 14:57:18.775946 | 2023-01-06 14:57:18.776974 | INACTIVE | hz1 | hangzhou | ReadWrite |
   +-------+----------------------------+----------------------------+----------+-----+----------+-----------+
   4 rows in set

   ```

   查询结果中有新添加的 Zone，则表示添加 Zone 成功，新添加成功的 Zone 的状态为 `INACTIVE`。

   有关 `DBA_OB_ZONES` 视图的更多详细信息，请参见 [oceanbase.DBA_OB_ZONES](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000641318)。
 4. 添加 Zone 后，如果需要使用该 Zone，还需要启动 Zone，使 Zone 的状态变为 `ACTIVE`。

   语句如下：

   ```shell
   obclient [(none)]> ALTER SYSTEM START ZONE zone_name;

   ```

   其中，`zone_name` 为待启动的 Zone 的名称。

   示例如下：

   ```shell
   obclient [(none)]> ALTER SYSTEM START ZONE zone4;
   Query OK, 0 rows affected

   obclient [(none)]> SELECT * FROM oceanbase.DBA_OB_ZONES;
   +-------+----------------------------+----------------------------+--------+-----+----------+-----------+
   | ZONE  | CREATE_TIME                | MODIFY_TIME                | STATUS | IDC | REGION   | TYPE      |
   +-------+----------------------------+----------------------------+--------+-----+----------+-----------+
   | zone1 | 2022-12-20 17:50:17.168745 | 2022-12-20 17:50:40.801054 | ACTIVE | HZ0 | hangzhou | ReadWrite |
   | zone2 | 2022-12-20 17:50:17.168745 | 2022-12-20 17:50:40.809504 | ACTIVE | HZ0 | hangzhou | ReadWrite |
   | zone3 | 2022-12-20 17:50:17.169804 | 2023-01-30 17:34:11.228474 | ACTIVE | HZ1 | hangzhou | ReadWrite |
   | zone4 | 2023-01-06 15:30:30.887362 | 2023-01-31 13:47:56.107429 | ACTIVE | hz1 | hangzhou | ReadWrite |
   +-------+----------------------------+----------------------------+--------+-----+----------+-----------+
   4 rows in set

   ```

   根据示例结果可知，成功启动 Zone 后，新添加的 Zone 的状态变为 `ACTIVE`。

## 后续操作

- 添加 Zone 后，如果需要修改 Zone 所在的 `idc_name` 或 `region_name`，您可以通过修改 Zone 来完成，修改 Zone 的详细操作可参见 [修改 Zone](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000639945)。
 - 添加 Zone 后，如果要使用该 Zone，还需要向该 Zone 中添加节点，添加节点的详细操作请参见 [添加节点](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000639946)。
 - 添加 Zone 后，新添加的 Zone 的状态为 `INACTIVE`，如果需要使该 Zone 内的节点能提供服务，还需要启动该 Zone，启动 Zone 的详细操作请参见 [启动 Zone](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000639932)。

## 相关文档

更多 Zone 相关的运维操作，请参见以下信息：

- [查看 Zone](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000639941)
 - [删除 Zone](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000639944)
 - [修改 Zone](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000639945)
 - [隔离 Zone](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000639937)

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