基于湖库一体架构,统一管理结构化、半结构化与非结构化等多模态数据,一个系统承载事务处理、实时分析与 AI 工作负载。
partition_index_dive_limit
更新时间:2026-10-29 17:22:34
功能描述
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]
说明
|
| 生效范围 |
|
| 是否可修改 | 是,支持通过 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 数据库通过本变量对存储层估行的分区数量进行限制。
配置示例
创建分区表
t1并插入数据。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查看执行计划,默认场景下不超过 10 个分区均采用存储层估行。
obclient [test]> EXPLAIN SELECT c1 FROM t1 WHERE c2 IN (1,11,21);查询结果如下:
+---------------------------------------------------------------------------------------------------------------+ | 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)修改变量,仅选择 1 个分区做存储层估行。
obclient [test]> SET partition_index_dive_limit = 1; Query OK, 0 rows affected (0.002 sec)再次查看执行计划,发现仅选择了一个分区做存储层估行,估行结果为 10 * 3 = 30。
obclient [test]> EXPLAIN SELECT c1 FROM t1 WHERE c2 IN (1,11,21);查询结果如下:
+---------------------------------------------------------------------------------------------------------------+ | 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)