---
title: "partition_index_dive_limit - OceanBase AI 数据库 V4.6.3 | OceanBase 文档中心"
description: partition_index_dive_limit 功能描述 partition_index_dive_limit 用于指示优化器使用存储层估行时的分区数量限制。 权限要求 查询变量 Global 级别 sys 租户和所有用户租户均可以使用 SHOW VARIABLES 语句或视图 information_sche…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*M1BcQZvbrRMAAAAAQGAAAAgAeiGDAQ/original) OceanBase AI 数据库V 4.6.3

# partition_index_dive_limit

更新时间：2026-10-29 17:22:34

[编辑](https://github.com/oceanbase/oceanbase-database-ai/edit/V4.6.3/zh-CN/700.reference/800.configuration-items-and-system-variables/200.system-variable/300.global-system-variable/10650.partition_index_dive_limit-global.md)  

## 功能描述

`partition_index_dive_limit` 用于指示优化器使用存储层估行时的分区数量限制。

## 权限要求

- 查询变量

     - Global 级别

      `sys` 租户和所有用户租户均可以使用 `SHOW VARIABLES` 语句或视图 `information_schema.GLOBAL_VARIABLES` 查看 Global 系统变量的值。
     - Session 级别

      `sys` 租户和所有用户租户均可以使用 `SHOW VARIABLES` 语句或视图 `information_schema.SESSION_VARIABLES` 查看 Session 系统变量的值。
 - 修改变量

     - Global 生效

           - `sys` 租户可以直接修改 Global 系统变量的值。
           - 用户租户需要拥有 `SUPER` 或 `ALTER SYSTEM` 权限才能修改 Global 系统变量的值。
     - Session 生效

      `sys` 租户和所有用户租户均可以直接修改本租户的 Session 系统变量的值。

## 属性说明

| **属性** | **描述** |
| --- | --- |
| 参数类型 | Int |
| 默认值 | 10 |
| 取值范围 | [0, INT64_MAX]   #### 说明    `0` 表示不设限。`INT64_MAX` 代表的是 64 位有符号整数类型的最大值。该变量允许设置为负数：当本变量与 `range_index_dive_limit` 同为负数时，存储层估行策略回退到旧版本行为，详见使用说明；其余情况下负数含义与 `0` 相同。 |
| 生效范围 | - Global - Session |
| 是否可修改 | 是，支持通过 `SET` 语句修改。 |

## 使用说明

修改该变量以控制优化器存储层估行时的分区数量限制：

- 当分区个数小于该变量时，总是选择所有分区做存储层估行。
 - 当分区个数大于等于该变量时，随机选择 `partition_index_dive_limit` 个分区进行存储层估行，并将估行结果等比例放大。
 - 当该变量为 `0` 时，总是选择所有分区做存储层估行。
 - 当 `range_index_dive_limit` 与 `partition_index_dive_limit` 同为负数时，存储层估行策略回退到旧版本行为，仅对单分区 10 个 range 以内做存储层估行，超过时不进行采样。
 - 如果需要关闭存储层估行，可以使用系统变量 `enable_storage_cardinality_estimation` 控制。

与 MySQL 的差异如下：

- MySQL 仅通过系统变量 `eq_range_index_dive_limit` 控制等值 range 数量，对分区数量没有限制；OceanBase AI 数据库通过本变量对存储层估行的分区数量进行限制。

## 配置示例

1. 创建分区表 `t1` 并插入数据。

   ```shell
   obclient [test]> CREATE TABLE t1(c1 int, c2 int, index i1(c2)) PARTITION BY RANGE(c1) (PARTITION p0 VALUES LESS THAN(10), PARTITION p1 VALUES LESS THAN(20), PARTITION p2 VALUES LESS THAN(30));
   Query OK, 0 rows affected (0.457 sec)

   obclient [test]> INSERT INTO t1 SELECT 1,1 FROM table(generator(10));
   Query OK, 10 rows affected (0.130 sec)
   Records: 10  Duplicates: 0  Warnings: 0

   obclient [test]> INSERT INTO t1 SELECT 11,11 FROM table(generator(20));
   Query OK, 20 rows affected (0.008 sec)
   Records: 20  Duplicates: 0  Warnings: 0

   obclient [test]> INSERT INTO t1 SELECT 21,21 FROM table(generator(30));
   Query OK, 30 rows affected (0.009 sec)
   Records: 30  Duplicates: 0  Warnings: 0

   ```
 2. 查看执行计划，默认场景下不超过 10 个分区均采用存储层估行。

   ```shell
   obclient [test]> EXPLAIN SELECT c1 FROM t1 WHERE c2 IN (1,11,21);

   ```

   查询结果如下：

   ```shell
   +---------------------------------------------------------------------------------------------------------------+
   | Query Plan                                                                                                    |
   +---------------------------------------------------------------------------------------------------------------+
   | =============================================                                                                 |
   | |ID|OPERATOR                 |NAME    |EST.ROWS|EST.TIME(us)|                                                 |
   | ---------------------------------------------                                                                 |
   | |0 |PX COORDINATOR           |        |60      |253         |                                                 |
   | |1 |└─EXCHANGE OUT DISTR     |:EX10000|60      |234         |                                                 |
   | |2 |  └─PX PARTITION ITERATOR|        |60      |193         |                                                 |
   | |3 |    └─TABLE RANGE SCAN   |t1(i1)  |60      |193         |                                                 |
   | =============================================                                                                 |
   | Outputs & filters:                                                                                            |
   | -------------------------------------                                                                         |
   |   0 - output([INTERNAL_FUNCTION(t1.c1)]), filter(nil), rowset=256                                             |
   |   1 - output([INTERNAL_FUNCTION(t1.c1)]), filter(nil), rowset=256                                             |
   |       dop=1                                                                                                   |
   |   2 - output([t1.c1]), filter(nil), rowset=256                                                                |
   |       force partition granule                                                                                 |
   |   3 - output([t1.c1]), filter(nil), rowset=256                                                                |
   |       access([t1.__pk_increment], [t1.c1]), partitions(p[0-2])                                                |
   |       is_index_back=true, is_global_index=false,                                                              |
   |       range_key([t1.c2], [t1.__pk_increment]), range(1,MIN ; 1,MAX), (11,MIN ; 11,MAX), (21,MIN ; 21,MAX),    |
   |       range_cond([t1.c2 IN (1, 11, 21)])                                                                      |
   +---------------------------------------------------------------------------------------------------------------+
   20 rows in set (0.063 sec)

   ```
 3. 修改变量，仅选择 1 个分区做存储层估行。

   ```shell
   obclient [test]> SET partition_index_dive_limit = 1;
   Query OK, 0 rows affected (0.002 sec)

   ```
 4. 再次查看执行计划，发现仅选择了一个分区做存储层估行，估行结果为 10 * 3 = 30。

   ```

   查询结果如下：

   ```shell
   +---------------------------------------------------------------------------------------------------------------+
   | Query Plan                                                                                                    |
   +---------------------------------------------------------------------------------------------------------------+
   | =============================================                                                                 |
   | |ID|OPERATOR                 |NAME    |EST.ROWS|EST.TIME(us)|                                                 |
   | ---------------------------------------------                                                                 |
   | |0 |PX COORDINATOR           |        |30      |253         |                                                 |
   | |1 |└─EXCHANGE OUT DISTR     |:EX10000|30      |234         |                                                 |
   | |2 |  └─PX PARTITION ITERATOR|        |30      |193         |                                                 |
   | |3 |    └─TABLE RANGE SCAN   |t1(i1)  |30      |193         |                                                 |
   | =============================================                                                                 |
   | Outputs & filters:                                                                                            |
   | -------------------------------------                                                                         |
   |   0 - output([INTERNAL_FUNCTION(t1.c1)]), filter(nil), rowset=256                                             |
   |   1 - output([INTERNAL_FUNCTION(t1.c1)]), filter(nil), rowset=256                                             |
   |       dop=1                                                                                                   |
   |   2 - output([t1.c1]), filter(nil), rowset=256                                                                |
   |       force partition granule                                                                                 |
   |   3 - output([t1.c1]), filter(nil), rowset=256                                                                |
   |       access([t1.__pk_increment], [t1.c1]), partitions(p[0-2])                                                |
   |       is_index_back=true, is_global_index=false,                                                              |
   |       range_key([t1.c2], [t1.__pk_increment]), range(1,MIN ; 1,MAX), (11,MIN ; 11,MAX), (21,MIN ; 21,MAX),    |
   |       range_cond([t1.c2 IN (1, 11, 21)])                                                                      |
   +---------------------------------------------------------------------------------------------------------------+
   20 rows in set (0.063 sec)

   ```

## 相关文档

- [range_index_dive_limit](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007109267)
 - [存储层估行](https://www.oceanbase.com/docs/common-oceanbase-database-standalone-1000000002702269)

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