基于湖库一体架构,统一管理结构化、半结构化与非结构化等多模态数据,一个系统承载事务处理、实时分析与 AI 工作负载。
partition_index_dive_limit
更新时间:2026-10-29 17:22:34
功能描述
partition_index_dive_limit 用于指示优化器使用存储层估行时的分区数量限制。
权限要求
查询变量
sys租户和所有用户租户均可以使用SHOW VARIABLES语句或视图information_schema.SESSION_VARIABLES查看 Session 系统变量的值。修改变量
sys租户和所有用户租户均可以直接修改本租户的 Session 系统变量的值。
属性说明
| 属性 | 描述 |
|---|---|
| 参数类型 | Int |
| 默认值 | 10 |
| 取值范围 | [0, INT64_MAX]
说明
|
| 生效范围 | 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 数据库通过本变量对存储层估行的分区数量进行限制。
配置示例
在当前 Session 中设置存储层估行的分区数量限制为 1,即随机选择 1 个分区进行存储层估行。
obclient [test]> SET partition_index_dive_limit = 1;
Query OK, 0 rows affected (0.002 sec)
通过执行计划观察估行结果的完整示例,参见 partition_index_dive_limit。