---
title: "手动控制合并 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心"
description: 手动控制合并 通过 MAJOR FREEZE 命令触发合并后，系统会自动调度合并任务。不同于 OceanBase 数据库 V2.x.x 和 V3.x.x 版本，从 OceanBase 数据库 V4.0.x 版本开始，合并将采用统一合并策略来执行合并流程，即租户的所有 Zone 同时开始执行合并，且所有 Zone 均完…
---
切换语言

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

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

# 手动控制合并

更新时间：2026-06-17 08:17:45

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/700.reference/200.system-management/500.manage-data-storage/200.merge-management/500.manually-control-a-merge.md)  

通过 `MAJOR FREEZE` 命令触发合并后，系统会自动调度合并任务。不同于 OceanBase 数据库 V2.x.x 和 V3.x.x 版本，从 OceanBase 数据库 V4.0.x 版本开始，合并将采用统一合并策略来执行合并流程，即租户的所有 Zone 同时开始执行合并，且所有 Zone 均完成合并后，才表示该租户完成合并。

合并过程中，不再需要您手动控制各个 Zone 的合并顺序等事项，也不存在轮转合并。如果在合并过程中出现错误，您可以参考本文手动控制合并。例如，Checksum 校验出错，会使得该租户当前轮次的合并无法结束，您可以暂停当前合并(suspend merge), 待 Checksum 恢复正确以后（例如，人工介入修复），再清理 Checksum 错误的标记（clear merge error）, 然后继续执行当前轮次的合并 (resume merge)。

## 前提条件

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

## 注意事项

当合并任务被暂停时，允许发起租户级合并，但不允许发起分区级合并。对于合并任务暂停时发起的租户级合并，系统并不会立即执行本次租户级合并任务，而是在恢复合并后才执行本次租户级合并。

## 系统租户手动控制合并

合并开始后，系统租户可以控制所有租户或指定租户的合并操作。可以控制的合并操作包括租户级合并和分区级合并。

具体操作如下：

1. 使用 `root` 用户登录集群的 `sys` 租户。
 2. 根据业务实际情况，选择合适的命令控制合并。

      - 暂停所有用户租户、所有 Meta 租户或指定租户的合并

       开始合并后，如果需要暂停所有用户租户、所有 Meta 租户或指定租户的合并，可以执行以下语句。

            - 暂停所有用户租户的合并

             ```sql
             ALTER SYSTEM SUSPEND MERGE TENANT = all_user;

             ```

             或者

             ```sql
             ALTER SYSTEM SUSPEND MERGE TENANT = all;

             ```

             #### 说明

             OceanBase 数据库从 V4.2.1 版本开始，`TENANT = all_user` 与 `TENANT = all`语义相同，在需要生效范围为所有用户租户时，推荐使用 `TENANT = all_user`，后续 `TENANT = all` 将废弃不再使用。
            - 暂停所有 Meta 租户的合并

             ```sql
             ALTER SYSTEM SUSPEND MERGE TENANT = all_meta;

             ```
            - 暂停指定租户的合并

             ```sql
             ALTER SYSTEM SUSPEND MERGE TENANT = tenant1，tenant2;

             ```

       其中，`=` 为可选; `tenant1`、`tenant2` 需要替换为实际的租户名。
      - 恢复合并

       暂停合并后，也可以恢复合并，语句如下。

            - 恢复所有用户租户的合并

             ```sql
             ALTER SYSTEM RESUME MERGE TENANT = all_user;

             ```

             或者

             ```sql
             ALTER SYSTEM RESUME MERGE TENANT = all;

             ```

             #### 说明

             OceanBase 数据库从 V4.2.1 版本开始，`TENANT = all_user` 与 `TENANT = all`语义相同，在需要生效范围为所有用户租户时，推荐使用 `TENANT = all_user`，后续 `TENANT = all` 将废弃不再使用。
            - 恢复所有 Meta 租户的合并

             ```sql
             ALTER SYSTEM RESUME MERGE TENANT = all_meta;

             ```
            - 恢复指定租户的合并

             ```sql
             ALTER SYSTEM RESUME MERGE TENANT = tenant1，tenant2;

             ```

       其中，`=` 为可选；`tenant1`、`tenant2` 需要替换为实际的租户名。
      - 清理 Checksum 错误的标记

       如果在合并过程中出现了 Checksum 校验错误，且人工介入修复后，可以清理掉该 Checksum 错误的标记，以恢复合并，语句如下。

            - 清理所有用户租户的 Checksum 错误的标记

             ```sql
             ALTER SYSTEM CLEAR MERGE ERROR TENANT = all_user;

             ```

             或者

             ```sql
             ALTER SYSTEM CLEAR MERGE ERROR TENANT = all;

             ```

             #### 说明

             OceanBase 数据库从 V4.2.1 版本开始，`TENANT = all_user` 与 `TENANT = all`语义相同，在需要生效范围为所有用户租户时，推荐使用 `TENANT = all_user`，后续 `TENANT = all` 将废弃不再使用。
            - 清理所有 Meta 租户的 Checksum 错误的标记

             ```sql
             ALTER SYSTEM CLEAR MERGE ERROR TENANT = all_meta;

             ```
            - 清理指定租户的 Checksum 错误的标记

             ```sql
             ALTER SYSTEM CLEAR MERGE ERROR TENANT = tenant1，tenant2;

             ```

       其中，`=` 为可选；`tenant1`、`tenant2` 需要替换为实际的租户名。

## 用户租户手动控制合并

合并开始后，用户租户只能控制本租户的合并操作。可以控制的合并操作包括租户级合并和分区级合并。

1. 用户租户的租户管理员登录到数据库。
 2. 根据业务实际情况，选择合适的命令控制合并。

      - 暂停本租户的合并

       开始合并后，如果需要暂停本租户的合并，可以执行以下语句。

       ```sql
       obclient> ALTER SYSTEM SUSPEND MERGE;

       ```
      - 恢复合并

       暂停合并后，也可以恢复合并。

       语句如下：

       ```sql
       obclient> ALTER SYSTEM RESUME MERGE;

       ```
      - 清理 Checksum 错误的标记

       如果在合并过程中出现了 Checksum 校验错误，且人工介入修复后，可以清理掉该 Checksum 错误的标记，以恢复合并。

       语句如下：

       ```sql
       obclient> ALTER SYSTEM CLEAR MERGE ERROR;

       ```

## 相关文档

- [自动触发合并](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005684830)
 - [定时触发每日租户合并](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005684837)
 - [手动触发合并](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005684831)
 - [查看合并信息](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005684833)

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