---
title: "手动触发合并 - OceanBase 数据库 V4.2.1 | OceanBase 文档中心"
description: 手动触发合并 合并也可以通过手动触发来完成。 前提条件 触发合并前，需要确保全局合并开关已开启，全局合并开关由集群级配置项 enable_major_freeze 控制，默认值为 True ，表示开启合并开关。 如果当前集群未开启全局合并开关，请参考以下操作开启全局合并开关。 使用 root 用户登录集群的 sys …
---
切换语言

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

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

# 手动触发合并

更新时间：2026-04-16 00:11:36

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

合并也可以通过手动触发来完成。

## 前提条件

触发合并前，需要确保全局合并开关已开启，全局合并开关由集群级配置项 `enable_major_freeze` 控制，默认值为 `True` ，表示开启合并开关。

如果当前集群未开启全局合并开关，请参考以下操作开启全局合并开关。

1. 使用 `root` 用户登录集群的 `sys` 租户。
 2. 确认全局合并开关是否已开启。

   ```sql
   obclient> SHOW PARAMETERS LIKE 'enable_major_freeze';

   ```
 3. 如果显示未开启，执行以下语句，开启合并开关。

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

   ```

   关于配置项 `enable_major_freeze` 的更多信息，请参见 [enable_major_freeze](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000220664)。

## 系统租户手动发起合并

系统租户可以对本租户、所有租户或指定租户发起合并操作。

具体操作如下：

1. 使用 `root` 用户登录集群的 `sys` 租户。
 2. 执行以下命令，发起合并。

   SQL 语句如下：

   ```sql
   obclient> ALTER SYSTEM MAJOR FREEZE TENANT [=] all_user | all | all_meta | tenant_name [, tenant_name ...];

   ```

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

   示例如下：

      - 系统租户对本租户发起合并

       ```sql
       obclient> ALTER SYSTEM MAJOR FREEZE;

       ```
      - 系统租户对所有用户租户发起合并

       ```sql
       obclient> ALTER SYSTEM MAJOR FREEZE TENANT = all_user;

       ```

       或者

       ```sql
       obclient> ALTER SYSTEM MAJOR FREEZE TENANT = all;

       ```

       #### 说明

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

       ```sql
       obclient> ALTER SYSTEM MAJOR FREEZE TENANT = all_meta;

       ```
      - 系统租户对指定租户发起合并

       ```sql
       obclient> ALTER SYSTEM MAJOR FREEZE TENANT = tenant1,tenant2;

       ```

## 用户租户手动发起合并

用户租户只能发起对本租户的合并操作。

1. 用户租户的租户管理员登录到数据库。
 2. 对本租户发起合并。

   语句如下：

   ```

## 相关文档

- [自动触发合并](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218881)
 - [定时触发合并](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218882)
 - [手动控制合并](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218884)
 - [查看合并过程](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218886)

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