ProcessUtility_hook
实用命令处理
供插件在 ProcessUtility() 中接管处理的钩子。
当前查看 PostgreSQL 18。
中文定义与说明
供插件在 ProcessUtility() 中接管处理的钩子。
以下中文为本站依据所列 PostgreSQL 源码注释编译的说明。
接口声明
typedef void (*ProcessUtility_hook_type) (PlannedStmt *pstmt, const char *queryString, bool readOnlyTree, ProcessUtilityContext context, ParamListInfo params, QueryEnvironment *queryEnv, DestReceiver *dest, QueryCompletion *qc); extern PGDLLIMPORT ProcessUtility_hook_type ProcessUtility_hook;
源码说明
此函数钩子变量允许可加载插件在 ProcessUtility 被调用时接管处理。插件通常应调用 standard_ProcessUtility()。
调用位置
src/backend/tcop/utility.c:519
核心调用上下文:src/backend/tcop/utility.c:513–527
/* * We provide a function hook variable that lets loadable plugins get * control when ProcessUtility is called. Such a plugin would normally * call standard_ProcessUtility(). */ if (ProcessUtility_hook) (*ProcessUtility_hook) (pstmt, queryString, readOnlyTree, context, params, queryEnv, dest, qc); else standard_ProcessUtility(pstmt, queryString, readOnlyTree, context, params, queryEnv, dest, qc); }
说明
供插件在 ProcessUtility() 中接管处理的钩子。
- 接口类型
- ProcessUtility_hook_type
- 声明头文件
- src/include/tcop/utility.h
- 调用阶段
- 解析与命令处理
- 初始值
- NULL(未安装钩子)
接口签名
typedef void (*ProcessUtility_hook_type) (PlannedStmt *pstmt, const char *queryString, bool readOnlyTree, ProcessUtilityContext context, ParamListInfo params, QueryEnvironment *queryEnv, DestReceiver *dest, QueryCompletion *qc);
extern PGDLLIMPORT ProcessUtility_hook_type ProcessUtility_hook;串接已有钩子
钩子变量只保存一个函数指针。扩展安装时应保存旧值;需要保留原行为时先调用旧钩子,旧值为空则调用相应的 standard_ 实现。直接再次调用同名公共入口可能重新进入自己的钩子。
调用位置
src/backend/tcop/utility.c:519
文档与源码
查看来源构建
- 版本
- 18
- 构建
- REL_18_STABLE
- 来源指纹
753057e340da8f22e57c9a409ea7a235fd6a46bd
同类条目
post_parse_analyze_hook语义分析后处理
返回扩展钩子 · 此条目的收录范围为 PostgreSQL 10 至 20;起点不一定是实际引入版本。