You need to enable JavaScript to run this app. PostgreSQL自定义计划节点ExecReScan触发场景及回归测试覆盖问题
优惠活动
大模型
产品
解决方案
定价
更多

PostgreSQL自定义计划节点ExecReScan触发场景及回归测试覆盖问题

提问

为PostgreSQL实现了全新的计划树节点,并为该节点编写了对应的Rescan函数,供execAmi.c中的ExecReScan逻辑调用。但覆盖率测试结果显示,该函数在开展的回归测试中从未被触发。

现存疑惑:

  • 不清楚ExecReScan的实际触发时机:虽然阅读了该函数的说明,得知其作用是重置计划节点以支持对其输出的重扫,但始终不知道具体什么场景下才会需要调用该逻辑
  • 不确定是否可以将该自定义节点的Rescan逻辑纳入回归测试覆盖范围
  • 尝试的触发操作完全无效:曾尝试在psql查询运行过程中使用Ctrl+C中断查询,但相关代码依然没有被触发
  • 参考官方文档中自定义扫描执行回调的相关内容,其中提到该回调的作用是将当前扫描回退到起始位置,为关系重扫做准备,但依旧不清楚该函数的实际触发时机
解答

ExecReScan的核心触发逻辑

ExecReScan本质是执行器层面的轻量状态重置接口,触发场景和查询中断、异常终止完全无关——只有在同一个查询的执行生命周期内,需要重复遍历某一个计划节点的全部输出时,才会调用该接口。常见的触发场景包括:

  • 嵌套循环连接(NestLoop)的内部扫描节点:这是占比最高的触发场景。当执行计划走NestLoop路径时,外层节点每返回1行匹配记录,就需要把内层扫描节点从头重新扫一遍,匹配当前行的连接条件,此时就会调用内层节点的ExecReScan逻辑,避免重复做节点初始化的开销。
  • 关联子查询的多次执行:当子查询和外层查询存在关联条件时,外层每处理1行数据,就需要重新执行一次子查询的计划树,执行器会直接调用子查询根节点的Rescan接口完成状态重置,而非重建整个子查询执行状态。
  • 窗口函数、增量排序等需要多次回读底层数据的算子:这类算子在执行过程中可能需要多次重新读取底层节点的输出结果,也会触发对应节点的Rescan调用。

你之前尝试用Ctrl+C中断查询触发失败是完全符合预期的:中断操作会直接走执行器的错误清理流程,释放所有节点的执行内存,根本不会走到正常的重扫逻辑分支,自然不会调用你写的Rescan函数。

自定义Rescan函数从未触发的常见原因

  • 计划路径未命中重扫场景:如果你的自定义节点在最终执行计划中,是作为HashJoin/MergeJoin的驱动节点、或者查询的根节点存在,执行器只会从头遍历一次节点输出,根本没有重扫需求,自然不会触发Rescan调用。
  • 回调挂载错误:检查自定义节点的执行接口结构体,确认你写的Rescan函数是否正确绑定到CustomScan对应的Rescan函数指针上——如果绑定到了默认的空实现,就算走到重扫分支,也不会进入你写的自定义逻辑。

回归测试覆盖Rescan逻辑的操作方法

  • 强制构造可触发重扫的执行计划:通过调整优化器开关(比如关闭HashJoin、MergeJoin,强制走NestLoop路径),让你的自定义扫描节点作为NestLoop的内部节点存在,此时外层每读出一行数据,就会触发一次Rescan调用。
  • 快速验证触发链路:在自定义Rescan函数的入口加一句日志输出(例如elog(LOG, "custom node rescan called")),运行测试查询后查看数据库日志,确认是否进入函数逻辑。
  • 测试时避免走异常路径:不要用中断查询这类异常操作尝试触发Rescan,这类路径和正常的重扫逻辑完全无关,只会浪费排查时间。

内容的提问来源于stack exchange,提问作者Bobi.Liu

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.30 19:36:05