ExecutorRun_hook

说明

ExecutorRun 运行已初始化的查询计划时调用此钩子。方向与行数参数影响本次执行请求；同一 QueryDesc 可能被多次运行，因此一次调用不一定代表整条查询已经结束。

接口类型

ExecutorRun_hook_type

声明头文件

src/include/executor/executor.h

调用阶段

查询执行

初始值

NULL（未安装钩子）

接口签名

typedef void (*ExecutorRun_hook_type) (QueryDesc *queryDesc, ScanDirection direction, uint64 count);
extern PGDLLIMPORT ExecutorRun_hook_type ExecutorRun_hook;

串接已有钩子

钩子变量只保存一个函数指针。扩展安装时应保存旧值；需要保留原行为时先调用旧钩子，旧值为空则调用相应的 standard_ 实现。直接再次调用同名公共入口可能重新进入自己的钩子。

版本差异

PostgreSQL 18 起的接口不再包含 execute_once 参数；跨版本扩展需要按目标版本适配。

调用位置

src/backend/executor/execMain.c:301

相关条目

• 执行器

文档与源码

• 接口声明
• 核心定义
• 调用位置

同类条目

• ExecutorEnd_hook执行器结束
• ExecutorFinish_hook执行器完成
• ExecutorStart_hook执行器启动