planner_hook

说明

查询即将生成 PlannedStmt 时调用此钩子。它接收分析和重写后的查询以及规划参数，返回计划语句。扩展可包装 standard_planner 来观测或调整规划过程，也可以提供自己的规划实现。

接口类型

planner_hook_type

声明头文件

src/include/optimizer/planner.h

调用阶段

查询规划

初始值

NULL（未安装钩子）

接口签名

typedef PlannedStmt *(*planner_hook_type) (Query *parse, const char *query_string, int cursorOptions, ParamListInfo boundParams);
extern PGDLLIMPORT planner_hook_type planner_hook;

串接已有钩子

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

调用位置

src/backend/optimizer/plan/planner.c:316

相关条目

• 规划器与优化器

文档与源码

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

同类条目

• create_upper_paths_hook上层查询路径
• get_relation_info_hook关系规划信息
• join_search_hook连接顺序搜索
• set_join_pathlist_hook连接访问路径
• set_rel_pathlist_hook关系访问路径