由 John Doe 九月 15, 2025
你觉得 EXPLAIN 不够用吗？现在，PostgreSQL 支持新的 pg_overexplain 扩展了。
特性提交日志
pg_overexplain：额外用于调试的 EXPLAIN 选项。
在计划（Plan）和计划状态（PlanState）树中，存在大量现有 EXPLAIN 选项无法输出的信息。这意味着，在开发查询规划器时，通常不得不依赖debug_print_plan这类工具，但它们会生成过于庞大的输出内容。因此，本功能借助新的 EXPLAIN 扩展机制，将EXPLAIN (DEBUG)和EXPLAIN (RANGE_TABLE)实现为核心 EXPLAIN 工具的扩展选项。
目前在此基础上仍有极大的优化空间，关于“输出哪些信息”以及“如何输出”的具体方案也存在讨论余地，但这至少为后续相关讨论提供了起点，也为未来可能的改进搭建了基础。
讨论：http://postgr.es/m/CA+TgmoZfvQUBWQ2P8iO30jywhfEAKyNzMZSR+uc2xr9PZBw6eQ@mail.gmail.com
示例
在 PostgreSQL 的世界里，EXPLAIN是诊断查询性能的核心工具。但随着扩展需求的激增，核心功能逐渐难以满足开发者的定制化调试需求。2025 年，PostgreSQL 开发者邮件列表的一场讨论中，开发者 Robert Haas 提交了一组补丁，其中pg_overexplain作为contrib模块的新成员，为查询计划调试注入了新的活力。
传统EXPLAIN虽能展示执行计划，但面对复杂的规划器逻辑（如范围表管理、调试信息聚合）时，开发者不得不依赖debug_print_plan输出的海量日志，效率低下。Robert Haas 在补丁中提到：EXPLAIN (RANGE_TABLE)能让优化器开发者更清晰地看到范围表的细节，而无需在冗长的调试日志中大海捞针。
pg_overexplain的诞生正是为了解决这类痛点：通过扩展EXPLAIN的能力，让开发者以更优雅的方式注入自定义调试信息，无需修改 PostgreSQL 核心代码。
EXPLAIN (RANGE_TABLE)：解析查询的关系表信息
范围表（Range Table, RTI）是 PostgreSQL 查询规划的基础，存储了表别名、关联关系等元信息。RANGE_TABLE选项会递归遍历整个计划树，输出每个节点关联的范围表细节：
EXPLAIN (RANGE_TABLE)
SELECT o.id, u.name
FROM orders o
JOIN users u ON o.user_id = u.id
WHERE o.status = 'completed';
Range Table Information (RTI 1):
Alias: o, Relation: public.orders
Columns: id (int4), user_id (int4), status (text)
Referenced By: Seq Scan (orders), Hash Join
Range Table Information (RTI 2):
Alias: u, Relation: public.users
Columns: id (int4), name (text)
Referenced By: Index Scan (users_pkey)
这一功能对理解多表关联、别名作用域及隐式转换非常重要，尤其适合追踪复杂查询优化时的元数据。
EXPLAIN (DEBUG)：轻量化的调试利器
替代debug_print_plan的“暴力输出”，DEBUG选项聚焦关键调试信息，如规划器的成本估算细节、未被EXPLAIN ANALYZE捕获的隐藏状态：
EXPLAIN (DEBUG)
SELECT * FROM large_table WHERE date_column = '2025-01-01';
Debug Information:
Planner Estimates: rows=5000 (stdev=15%), width=200
Join Order: Optimized (cost reduction: 32.7%)
Index Usage: IndexScan using idx_date on large_table (cost: 0.42-45.89)
相比全局开启debug_print_plan，DEBUG更精准，避免干扰常规EXPLAIN输出。
pg_overexplain的出现，让 PostgreSQL 查询规划的黑盒状态变得更透明。无论是排查线上慢查询，还是开发自定义优化扩展，它都是开发者工具箱中不可或缺的透视镜。
非常不错的体验。感谢社区的所有相关人员。
参考
提交日志：https://git.postgresql.org/pg/commitdiff/8d5ceb113e3f7ddb627bd40b26438a9d2fa05512