↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / 扩展钩子 / 解析与命令处理

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

同类条目

返回扩展钩子 · 此条目的收录范围为 PostgreSQL 10 至 20;起点不一定是实际引入版本。