PostgreSQL 索引类型全景指南：GIN、GiST、BRIN、Hash 与 SP-GiST 选型终极清单

PostgreSQL 索引类型全景指南：GIN、GiST、BRIN、Hash 与 SP-GiST 选型终极清单

【免费下载链接】postgresMirror of the official PostgreSQL GIT repository. Note that this is just a *mirror* - we don't work with pull requests on github. To contribute, please see https://wiki.postgresql.org/wiki/Submitting_a_Patch项目地址: https://gitcode.com/gh_mirrors/po/postgres

PostgreSQL 索引类型有哪些？本文带你快速搞懂 GIN、GiST、BRIN、Hash 与 SP-GiST 五种索引的适用场景与性能特点，并附上一张终极选型清单，帮你为数组、JSONB、地理位置、全文检索、十亿行日志表等场景挑对索引，告别低效的全表扫描。

🧭 PostgreSQL 索引类型总览：一张表看懂 5 种索引

除默认的 B-tree 外，PostgreSQL 内置 5 种高级索引类型，它们都实现了统一的索引访问方法框架（源码位于 src/backend/access/）：

官方文档的"Indexes"章节对每种索引有完整说明，可参考 doc/src/sgml/indices.sgml。

📦 GIN 索引：数组与 JSONB 的"倒排神器"

GIN（Generalized Inverted Index）是倒排索引：一个值里包含多个组件（如数组元素、JSONB 键值），每个组件单独建立入口，从而高效处理"包含某个值"的查询。源码入口：src/backend/access/gin/gininsert.c。

适用场景

• 数组列：tags @> ARRAY['pgsql']、tags && ARRAY['sql']
• JSONB：键值提取与@>包含判断
• 全文检索：to_tsvector文本匹配查询

注意：GIN 写入开销大（每行数据要拆成多个条目），高写入场景可依赖默认的fastupdate机制缓冲。详细说明见 doc/src/sgml/gin.sgml。

🌍 GiST 索引：多维数据与"最近邻"搜索首选

GiST（Generalized Search Tree）不是单一索引，而是一个可扩展的索引框架——几何、区间、全文、扩展类型都可以接入。标准发行版自带点、盒子等几何类型的操作类。

适用场景

• 地理坐标：location <-> point '(101,456)'这类 KNN 近邻搜索
• 区间类型：int8range、tsrange的包含/重叠判断
• 扩展接入：contrib/btree_gist/btree_gist.c 让普通 B-tree 列也能复用 GiST 框架

实现源码：src/backend/access/gist/gist.c，框架设计自述见 src/backend/access/gist/README。

注意：GiST 不支持唯一约束；多列索引时首列要有足够区分度，否则效率大打折扣。

🌲 SP-GiST 索引：四叉树与 kd 树的空间利器

SP-GiST（Space Partitioned GiST）与 GiST 不同，它支持非平衡的磁盘数据结构：四叉树（quadtree）、kd 树、基数树（trie）。

• 点/盒子：四叉树做范围查询，比平衡树更省空间（src/backend/access/spgist/spgquadtreeproc.c）
• 文本：前缀树加速前缀匹配（src/backend/access/spgist/spgtextproc.c）

官方文档：doc/src/sgml/spgist.sgml。

🗂️ BRIN 索引：十亿行日志表的"空间省钱方案"

BRIN（Block Range INdex）不逐行记录，只保存每 N 个物理块的 min/max 摘要，索引体积可缩小 1~3 个数量级。

生效前提：列值与行的物理位置高度相关（例如时间戳随插入递增）。

不适用：大量随机 UPDATE、乱序插入的列——摘要范围被拉大后扫描会明显退化。数据整理后可用 VACUUM 或pg_brin_summarize刷新摘要。

实现源码：src/backend/access/brin/brin.c；参数pages_per_range控制每个摘要覆盖的块数（默认 128 页）。文档见 doc/src/sgml/brin.sgml。

🔑 Hash 索引：只干等值匹配这一件事

Hash 索引对列值取 32 位哈希码分桶，只支持=等值查询，不支持范围、排序和唯一约束。

何时选它：列基数高、查询全是等值条件、且想比 B-tree 更紧凑时。多数场景下 B-tree 仍是更通用的默认选择（等值、范围、排序全能覆盖）。

实现源码：src/backend/access/hash/hash.c。

✅ 索引选型终极清单：场景 → 索引 对照表

🛠️ 三个让索引发挥最大价值的习惯

1. 先 EXPLAIN 再建索引：确认执行计划真的走目标索引，避免白建；
2. 大表建索引用 CONCURRENTLY：线上环境避免长时间锁写；
3. 定期 ANALYZE：保持统计信息新鲜，优化器才能正确选路。

💡 记住：索引不是越多越好。每个索引都会拖慢 INSERT/UPDATE，长期无人使用的索引应当果断删除。

【免费下载链接】postgresMirror of the official PostgreSQL GIT repository. Note that this is just a *mirror* - we don't work with pull requests on github. To contribute, please see https://wiki.postgresql.org/wiki/Submitting_a_Patch项目地址: https://gitcode.com/gh_mirrors/po/postgres