---
title: "CLEAR_BALANCE_WEIGHT - OceanBase 数据库 V4.2.5 | OceanBase 文档中心"
description: CLEAR_BALANCE_WEIGHT CLEAR_BALANCE_WEIGHT 用于清除分区权重。 使用限制及注意事项 对于 V4.2.5 版本，从 V4.2.5 BP2 开始支持清除分区权重。 仅用户租户支持通过调用 CLEAR_BALANCE_WEIGHT 子程序清除分区权重，系统租户不支持清除分区权重。 清…
---
切换语言

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

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

# CLEAR_BALANCE_WEIGHT

更新时间：2026-07-15 20:56:58

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.5/zh-CN/700.reference/500.sql-reference/300.pl-reference/300.pl-oracle/1400.pl-system-package-oracle/2700.dbms-balance-oracle/160.clear-balance-weight-oracle.md)  

`CLEAR_BALANCE_WEIGHT` 用于清除分区权重。

## 使用限制及注意事项

- 对于 V4.2.5 版本，从 V4.2.5 BP2 开始支持清除分区权重。
 - 仅用户租户支持通过调用 `CLEAR_BALANCE_WEIGHT` 子程序清除分区权重，系统租户不支持清除分区权重。
 - 清除表级分区权重是将所有分区上设置的表级权重删除。如果该表设置过分区级权重，则系统会保留分区级权重。

## 语法

```sql
DBMS_BALANCE.CLEAR_BALANCE_WEIGHT(
    schema_name         IN VARCHAR2,
    table_name          IN VARCHAR2,
    partition_name      IN VARCHAR2 DEFAULT NULL,
    subpartition_name   IN VARCHAR2 DEFAULT NULL);

```

## 参数说明

| **参数** | **说明** |
| --- | --- |
| schema_name | 表所属的 Schema 名 |
| table_name | 表名 |
| partition_name | 一级分区名 |
| subpartition_name | 二级分区名。仅语法支持，当前暂不支持设置二级分区权重。 |

## 示例

1. 假设用户 `USR2` （Oracle 模式中 Schema 名与用户名同名）下，有一设置了分区权重的表 `TBL1_H`。

   查询其分区权重信息，语句如下：

   ```shell
   obclient[USR2]> SELECT * FROM SYS.DBA_OB_OBJECT_BALANCE_WEIGHT;

   ```

   查询结果如下：

   ```shell
   +----------+--------------+-----------------+--------+---------------+------------+----------------+-------------------+-----------------+-------------+---------------+-----------+
   | TABLE_ID | PARTITION_ID | SUBPARTITION_ID | WEIGHT | DATABASE_NAME | TABLE_NAME | PARTITION_NAME | SUBPARTITION_NAME | TABLEGROUP_NAME | DATABASE_ID | TABLEGROUP_ID | OBJECT_ID |
   +----------+--------------+-----------------+--------+---------------+------------+----------------+-------------------+-----------------+-------------+---------------+-----------+
   |   500002 |         NULL |            NULL |      1 | USR2          | TBL1_H     | NULL           | NULL              | NULL            |      201006 |          NULL |    500002 |
   |   500002 |       500003 |            NULL |      2 | USR2          | TBL1_H     | P0             | NULL              | NULL            |      201006 |          NULL |    500003 |
   +----------+--------------+-----------------+--------+---------------+------------+----------------+-------------------+-----------------+-------------+---------------+-----------+
   2 rows in set

   ```
 2. 清除表 `TBL1_H` 的表级分区权重。

   ```shell
   obclient [USR2]> delimiter //

   ```

   ```shell
   obclient[USR2]> BEGIN
             DBMS_BALANCE.CLEAR_BALANCE_WEIGHT('USR2','TBL1_H');
             END;//

   ```

   ```shell
   obclient [USR2]> delimiter ;

   ```
 3. 清除后，查询表设置过的分区权重信息。

   ```

   结果如下：

   ```shell
   +----------+--------------+-----------------+--------+---------------+------------+----------------+-------------------+-----------------+-------------+---------------+-----------+
   | TABLE_ID | PARTITION_ID | SUBPARTITION_ID | WEIGHT | DATABASE_NAME | TABLE_NAME | PARTITION_NAME | SUBPARTITION_NAME | TABLEGROUP_NAME | DATABASE_ID | TABLEGROUP_ID | OBJECT_ID |
   +----------+--------------+-----------------+--------+---------------+------------+----------------+-------------------+-----------------+-------------+---------------+-----------+
   |   500002 |       500003 |            NULL |      2 | USR2          | TBL1_H     | P0             | NULL              | NULL            |      201006 |          NULL |    500003 |
   +----------+--------------+-----------------+--------+---------------+------------+----------------+-------------------+-----------------+-------------+---------------+-----------+
   1 row in set

   ```
 4. 清除表 `TBL1_H` 中一级分区 `P0` 的分区权重。

   ```

   ```shell
   obclient[USR2]> BEGIN
           DBMS_BALANCE.CLEAR_BALANCE_WEIGHT('USR2','TBL1_H','P0');
           END;//

   ```

   ```
 5. 清除后，再次查询表设置过的分区权重信息。

   ```

   查询结果为空。

## 相关文档

- [租户内均衡](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001502852)
 - [设置分区权重](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002072270)
 - [清除分区权重](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002072271)

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