---
title: "TRIGGER_PARTITION_BALANCE - OceanBase 数据库 V4.5.0 | OceanBase 文档中心"
description: TRIGGER_PARTITION_BALANCE TRIGGER_PARTITION_BALANCE 用于手动触发分区均衡。 语法 DBMS_BALANCE.TRIGGER_PARTITION_BALANCE(balance_timeout INT DEFAULT NULL); 参数说明 参数 balance_ti…
---
切换语言

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

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

# TRIGGER_PARTITION_BALANCE

更新时间：2026-04-07 20:27:15

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.5.0/zh-CN/700.reference/600.pl-reference/200.pl-mysql/1000.pl-system-package-mysql/20800.dbms-balance-mysql/200.trigger-partition-balance-mysql.md)  

`TRIGGER_PARTITION_BALANCE` 用于手动触发分区均衡。

## 语法

```sql
DBMS_BALANCE.TRIGGER_PARTITION_BALANCE(balance_timeout INT DEFAULT NULL);

```

## 参数说明

参数 `balance_timeout` 单位秒，用于控制后台均衡任务的超时时间。

## 注意事项

- 该系统包只能在用户租户下调用。sys 租户调用报错 `OB_OP_NOT_ALLOW`。
 - 当租户级配置项 `enable_rebalance` 或 `enable_transfer`关闭时，报错 `OB_OP_NOT_ALLOW`，不允许手动触发分区均衡。
 - 当有其他均衡任务正在进行时，报错 `OB_OP_NOT_ALLOW`，需等待当前均衡任务完成后再执行。
 - 若当前租户已经分区均衡，报错 `OB_PARTITION_ALREADY_BALANCED`。

## 示例

- 触发 1 次分区均衡，后台均衡任务无超时时间，做完为止。

  ```shell
  obclient> CALL DBMS_BALANCE.TRIGGER_PARTITION_BALANCE();

  ```
 - 触发分区均衡后，后台均衡任务最多运行 2h，做不完超时取消。

  ```shell
  obclient> CALL DBMS_BALANCE.TRIGGER_PARTITION_BALANCE(7200);

  ```

## 相关阅读

- [enable_rebalance](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004478930)
 - [enable_transfer](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004478879)

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