---
title: "手动控制合并 | OceanBase 文档中心"
description: 手动控制合并 通过 MAJOR FREEZE 命令触发合并后，默认情况下，系统会自动调度合并任务，按照您指定的合并策略进行合并操作，例如，您可以打开轮转合并开关，系统会自动调度按 Zone 轮转合并。OceanBase 数据库还提供了手动控制合并的方法，让用户手动控制合并流程。 典型场景如下： 合并过程中，其中一个 …
---
切换语言

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

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

# 手动控制合并

更新时间：2026-06-06 15:40:25

通过 `MAJOR FREEZE` 命令触发合并后，默认情况下，系统会自动调度合并任务，按照您指定的合并策略进行合并操作，例如，您可以打开轮转合并开关，系统会自动调度按 Zone 轮转合并。OceanBase 数据库还提供了手动控制合并的方法，让用户手动控制合并流程。

典型场景如下：

- 合并过程中，其中一个 Zone 出现错误，例如 Checksum 校验出错，为了防止错误扩散到其他 Zone，可以停止自动调度或暂停合并，待问题排查解决后，再恢复自动调度或者手动控制完成合并。
 - 您希望手动控制合并流程，由自己决定合并时间及各个 Zone 的合并顺序等，可以采用手动控制合并方法。

## 前提条件

手动控制合并前，请确认已通过 `MAJOR FREEZE` 命令触发合并，手动触发合并的详细操作，请参见 [手动触发合并](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946263)。

## 操作步骤

1. 使用 `root` 用户登录到数据库的 `sys` 租户。
 2. 执行以下语句，开启手动控制合并开关。

   ```sql
   obclient> ALTER SYSTEM SET enable_manual_merge='True';

   ```

   配置项 `enable_manual_merge` 用于控制是否开启手动控制合并，默认值为 `False` ，表示关闭手动控制合并开关。

   关于配置项 `enable_manual_merge` 的更多信息，请参见 [enable_manual_merge](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944987)。
 3. 开始合并。

   开始合并指定的 Zone 的语法如下：

   ```sql
   obclient> ALTER SYSTEM START MERGE ZONE [=] 'zone_name';

   ```

   其中，`[=]` 表示等号（=）为可选；`zone_name` 表示准备开始合并的 Zone，多个 Zone 之间用英文逗号（,）分隔。

   示例：

   ```sql
   obclient> ALTER SYSTEM START MERGE ZONE = 'zone1';

   ```
 4. （可选）开始合并后，如果您需要暂停合并，可以执行以下语句。

   ```sql
   obclient> ALTER SYSTEM SUSPEND MERGE [ZONE [=] 'zone_name'];

   ```

   其中，`[=]` 表示等号（=）为可选。
 5. （可选）暂停合并后，也可以恢复合并。

   语法如下：

   ```sql
   obclient> ALTER SYSTEM RESUME MERGE [ZONE [=] 'zone_name'];

   ```

   其中，`[=]` 表示等号（=）为可选。

## 相关阅读

- [自动触发合并](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946261)
 - [定时触发合并](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946262)
 - [手动触发合并](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946263)
 - [查看合并过程](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945931)
 - [查看合并过程中的磁盘使用情况](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945932)

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