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