pg_table_range

概览

Experimental. 0.1.2 fixes missing rows and backend crashes. From 0.1.1: install new binaries, restart all backends, UPDATE extension, REINDEX each table_range index (parent for partitioned tables); old summaries are ignored until rebuilt.

版本

构建

您可以使用 pig build 命令构建 pg_table_range 扩展的 RPM 包：

pig build pkg pg_table_range         # 构建 RPM 包

安装

您可以直接安装 pg_table_range 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展：

pig install pg_table_range;          # 当前活跃 PG 版本安装

pig ext install -y pg_table_range -v 18  # PG 18
pig ext install -y pg_table_range -v 17  # PG 17
pig ext install -y pg_table_range -v 16  # PG 16

dnf install -y pg_table_range_18       # PG 18
dnf install -y pg_table_range_17       # PG 17
dnf install -y pg_table_range_16       # PG 16

创建扩展：

CREATE EXTENSION pg_table_range;

用法

来源：

• 上游 README
• 版本与 PostgreSQL 特性矩阵
• 规划器钩子与 GUC 注册
• 0.1.2 upgrade and correctness fixes

pg_table_range 是面向 PostgreSQL 16–18 的实验性扩展，用于在规划期按非分区键列剪枝。其 table_range 索引访问方法保存每个分区的实际标量最小值与最大值、范围外延，或 PostGIS 几何外延。只有当摘要能够证明分区不可能匹配时，规划器钩子才会移除它。

基本用法

在分区表上构建摘要索引，并用代表性谓词对比执行计划：

CREATE EXTENSION pg_table_range;

CREATE INDEX events_tr
ON events USING table_range (val, created_at);

EXPLAIN (COSTS OFF)
SELECT *
FROM events
WHERE val >= 250;

SET table_range.enable_pruning = off;
EXPLAIN (COSTS OFF)
SELECT *
FROM events
WHERE val >= 250;
RESET table_range.enable_pruning;

该索引永远不会被选中来扫描行；它拥有供规划器使用的紧凑摘要。插入会自动拓宽摘要。删除仍然安全，但可能让摘要比实际存活数据更宽，直到 REINDEX 将其收紧；VACUUM 不会重建摘要。

受支持的剪枝谓词包括标量比较、BETWEEN、空值测试、常量 IN 或 ANY 列表，以及范围与 PostGIS 几何类型的重叠。不受支持的表达式会保守地保留分区。

从 0.1.1 升级

0.1.2 修复了 0.1.1 的漏行与后端崩溃问题。先安装新二进制文件并重启 PostgreSQL，确保所有后端都不再运行旧代码。随后升级扩展，并重建每个 table_range 索引；分区表应重建父索引：

ALTER EXTENSION pg_table_range UPDATE TO '0.1.2';
REINDEX INDEX events_tr;

重建前会忽略旧摘要，保留全部分区，以免错误剪枝。此版本拒绝部分索引。删除后如需收紧摘要，也应使用 REINDEX。

注意事项

• 上游明确将项目标记为实验性且高度由 AI 驱动。采用前应在仿真生产数据上验证正确性、崩溃恢复、升级和规划器行为。
• 规划成本随分区数量线性增长。原生分区键剪枝便宜得多；只有当选择性非键谓词的执行收益足以抵消规划工作时，才应使用 pg_table_range。
• 索引创建与非键规划都会锁定所有分区。当分区数达到数千时，默认 max_locks_per_transaction 可能导致共享内存不足错误；增大它会消耗共享内存，且需要重启。
• 删除可能降低选择性，直到维护重建或收紧摘要。失效的 table_range 索引会默默禁用剪枝。
• 控制文件要求由超级用户安装。应限制表与索引 DDL 权限，并针对确切的 PostgreSQL 大版本测试 Rust/pgrx 构建。