Pg_sorted_heap: Sorted heap table AM for PostgreSQL with zone map scan pruning

说明与用途

**项目简介**
Pg_sorted_heap 是一个 PostgreSQL 的自定义表访问方法（AM），实现了“排序堆表”（sorted‑heap）并配备了 zone map 扫描裁剪功能。它通过在磁盘上保持行的有序布局以及区域级别的最小/最大值索引，能够在查询时显著减少不必要的块读取，从而提升大规模数据的查询性能。

**价值**

• **更快的数据访问**：在范围查询、时间序列或按键排序的场景下，利用 zone map 剪枝可避免全表扫描，查询延迟通常降低 30%‑70%。
• **降低业务代码复杂度**：无需在业务层自行实现分区、排序或归档逻辑，直接通过 PostgreSQL 的标准 SQL 接口使用即可。
• **原型与内部工具友好**：对需要快速验证大数据存储方案的团队而言，提供了比普通 heap 更好的性能，同时保持 PostgreSQL 完整的生态（事务、并发、扩展等）。

**典型接入方式**

1. **源码编译**：克隆仓库后在 PostgreSQL 源码树的 contrib 目录中编译 make && make install，生成 sorted_heap.so。
2. **在数据库中注册**：在目标数据库执行 CREATE EXTENSION sorted_heap;（或手动 CREATE ACCESS METHOD sorted_heap TYPE = heap HANDLER sorted_heap_handler;）。
3. **创建表**：使用新访问方法创建表，例如

   CREATE TABLE events (
       ts   timestamptz,
       id   bigint,
       data jsonb
   ) USING sorted_heap
   WITH (fillfactor = 80);

1. **可选配置**：通过 ALTER TABLE … SET (sorted_heap.zone_map = on); 启用 zone map；根据数据写入特性调节 fillfactor、maintenance_work_mem 等参数。

**生产可用性**

• **成熟度**：当前评分 41/100，属于 **中等** 稳定性。代码最近一次更新于 2026‑05‑12，社区活跃度有限。
• **适用场景**：非常适合内部原型、数据探索或对查询性能有明确提升需求的业务（如日志分析、时间序列存储）。在对可靠性要求极高的生产环境中使用前，需要完成以下检查：
• **许可证与合规**：确认项目采用的开源许可证（MIT/Apache 等）是否符合公司政策。
• **维护与社区**：审查 issue、PR 活动以及维护者的响应速度，评估后续 bug 修复和功能迭代的可行性。
• **文档与测试**：补充缺失的使用文档，运行项目自带的回归测试或自行编写关键路径的集成测试。
• **依赖管理**：确保编译环境与目标 PostgreSQL 版本（建议 15 以上）兼容，并在 CI/CD 流程中加入二进制校验。

综上，Pg_sorted_heap 在提升查询效率和简化数据持久化方案方面具有明显价值，适合作为 **原型或内部工具** 的加速层。若要在生产环境正式上线，建议先在预生产环境进行充分验证，并做好持续维护和监控的准备。

实际用途

Pg_sorted_heap: Sorted heap table AM for PostgreSQL with zone map scan pruning helps teams persist, query, and move data with less custom plumbing.

• manage persistence
• speed up data access
• prototype database-backed apps

限制与审查说明

Medium: useful for prototypes or internal workflows, with dependency and maintenance checks before production.