讲师中心 微信公众号
AI工具推荐 视频效率加速

SQL JSONB 的 @> 包含查询与 GIN 索引的加速效果实测

星辰君_9469

星辰君_9469

发布时间:2026-02-21 10:26:03

|

328人浏览过

|

来源于php中文网

原创

JSONB @> 查询慢的主因是未建匹配的GIN索引或查询写法不匹配索引;必须显式创建jsonb_path_ops索引,且索引字段与查询路径严格一致,否则仍会全表扫描。

sql jsonb 的 @> 包含查询与 gin 索引的加速效果实测

JSONB @> 查询为什么慢得离谱

没建对索引的 @> 查询,哪怕只查几千行,也可能比全表扫描还慢。PostgreSQL 不会自动为 JSONB 字段建 GIN 索引,更不会猜你想按哪个路径查——它默认连字段最外层都懒得索引。

常见错误现象:EXPLAIN 显示 Seq Scan,哪怕 WHERE 里写了 data @> '{"status":"active"}';或者加了索引但查询仍不走,因为索引定义和查询模式不匹配。

  • GIN 索引必须显式创建,且要指定操作符类:USING GIN (data jsonb_path_ops) 或 USING GIN (data jsonb_ops)
  • jsonb_path_ops 更轻量、索引小、查询快,但只支持 @>、、<code>?、?|、?& 这几种操作;不支持 #> 路径提取或键存在性模糊匹配(如 data ? 'tags')
  • jsonb_ops 功能全,支持所有 JSONB 操作,但索引体积大、构建慢、查询略慢——别一上来就用它
  • 如果查的是嵌套结构,比如 data #> '{user,profile}' @> '{"age": 30}',GIN 索引对这种写法完全无效;必须把路径“扁平化”进索引,或改用表达式索引

GIN 索引怎么建才让 @> 真正生效

索引字段和查询条件必须“对得上”。不是建了 GIN 就万事大吉,PostgreSQL 对 JSONB 索引路径极其严格。

使用场景:高频查询固定结构的子对象,例如订单数据中查 metadata @> '{"source":"web"}',或用户配置中查 settings @> '{"theme":"dark"}'。

  • 最简有效建法:CREATE INDEX idx_orders_metadata_gin ON orders USING GIN (metadata jsonb_path_ops);
  • 如果总查某个固定路径,比如 data -> 'flags' @> '{"verified": true}',建表达式索引更高效:CREATE INDEX idx_data_flags_gin ON t USING GIN ((data -> 'flags') jsonb_path_ops);
  • 别在 jsonb_ops 上建索引后,却用 data -> 'items' @> ... —— 路径提取操作会让索引失效;jsonb_path_ops 只认完整字段或 #>/#>> 提取后的值,但不认 -> 或 ->>
  • 建完立刻 VACUUM ANALYZE table_name,否则统计信息不准,查询计划器可能继续选错执行路径

EXPLAIN 看不出走索引?先盯紧这几个点

EXPLAIN 显示没走 GIN,不一定是索引建错了,很可能是查询写法或数据分布触发了计划器的“理性放弃”。

Comprehensive Three.js 3D graphics reference
Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

常见错误现象:索引明明存在,EXPLAIN 却显示 Bitmap Heap Scan 后跟一堆 Recheck Cond,甚至退化成 Seq Scan;或者 Rows Removed by Index Recheck 高得反常。

  • 检查是否用了非 sargable 写法:比如 (data @> '{"x":1}') = true,多一层括号+比较会让索引失效;直接写 data @> '{"x":1}'
  • 确认数据选择性:如果 data @> '{"status":"active"}' 匹配 80% 的行,PG 很可能跳过索引——它算出来走索引再回表比直接扫还贵
  • 留意隐式类型转换:data @> '{"count": "5"}'(字符串) vs data @> '{"count": 5}'(数字),JSONB 是强类型的,类型不对就无法命中索引
  • 用 EXPLAIN (ANALYZE, BUFFERS),重点看 Buffers shared hit 和 Index Cond 是否出现;没出现 Index Cond 基本等于没用上

嵌套数组匹配(如 tags @> ['a','b'])的坑

JSONB 数组的包含查询 @> 表面简单,实际极易踩空——尤其当字段是数组、而你想查“包含全部指定元素”时。

使用场景:标签系统查同时带 "backend" 和 "api" 的记录:tags @> '["backend","api"]'。

  • 这个查询能走 jsonb_path_ops 索引,但前提是 tags 字段本身就是 JSONB 数组类型(["a","b"]),不是字符串 "[\"a\",\"b\"]" 或对象 {"list":["a","b"]}
  • 如果数据存的是对象包装的数组,比如 {"tags": ["a","b"]},那必须用表达式索引:CREATE INDEX idx_tags_arr ON t USING GIN ((data -> 'tags') jsonb_path_ops);,然后查 data -> 'tags' @> '["a","b"]'
  • 注意 @> 是“超集”语义:查 ["a","b"] 会匹配 ["a","b","c"],但不会匹配 ["a"];如果想查“至少含其一”,得用 ? 或 ?|,它们也走 GIN,但索引定义一样
  • 数组元素顺序无关,但大小写和空格敏感:'["A"]' ≠ '["a"]','["x "]' ≠ '["x"]'

真正卡住人的往往不是语法,而是索引策略和查询写法之间那几毫米的错位——少一个 jsonb_path_ops,多一层 ->,换一种数组存法,效果就天差地别。实测时别只信 EXPLAIN 的第一行,往下翻三行看 Index Cond 和 Rows Removed 才算数。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

3883

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

831

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

1009

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

5721

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2683

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

5700

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

7521

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

1030

2024.04.29

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

0

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 20.7万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn