YugabyteDB查询JSONB列时表达式索引未生效问题咨询

问题原因 #

1. 字符串等值查询走索引的底层逻辑 #

你创建的是表达式部分索引，索引键为(doc->>'year')::int，前置过滤条件为doc->>'year' is not null。
当你执行where (doc->>'year') = '1988'的等值查询时，规划器会自动推导该条件等价于(doc->>'year')::int = 1988，同时隐含了doc->>'year'不为空的约束，完全匹配索引的定义，因此可以正常触发索引扫描。

2. 数值范围查询未触发索引的核心原因 #

• 统计信息不准确：如果表创建/插入数据后未执行ANALYZE更新统计信息，规划器无法准确估算(doc->>'year')::int > 1850的返回行数，默认估算返回占比过高时，会判定全表扫描+排序的代价低于索引扫描，因此选择走顺序扫描。
• 版本适配问题：2.14之前的YugabyteDB稳定版存在表达式索引范围谓词的匹配缺陷，规划器无法正确识别范围查询和表达式索引的匹配关系。
• 代价估算参数不合理：YugabyteDB为分布式存储，随机IO和顺序IO的代价差异远小于本地磁盘，默认random_page_cost值为4的配置偏高，会让规划器更倾向于选择全表扫描而非索引扫描。

解决方案 #

• 优先更新统计信息：执行以下命令更新表的统计信息后重新验证执行计划，90%以上的场景下该操作即可解决问题：

ANALYZE books;

统计信息准确后，规划器不仅会选择索引扫描，还能直接利用索引的排序属性跳过order by对应的Sort算子，执行效率提升非常明显。

• 调整代价估算参数：如果更新统计信息后仍未走索引，可调整会话级/全局的随机IO代价参数，让规划器更倾向于选择索引：

-- 会话级生效，测试用
SET random_page_cost = 1.1;

• 显式指定索引Hint：如果不想调整全局参数，可在查询中添加Hint强制使用目标索引：

SELECT /*+ IndexScan(books books_year) */
  (doc->>'ISBN')::bigint as isbn,
  doc->>'title'          as title,
  (doc->>'year')::int    as year
from books
where (doc->>'year')::int > 1850
order by 3;

• 版本升级：如果使用的是2.14之前的旧版本YugabyteDB，升级到最新稳定版即可修复表达式索引范围匹配的已知缺陷。

内容的提问来源于stack exchange，提问作者dh YB