4-宋少华-PostgreSQL Extension解析V1.0.pdf

1、PostgreSQL Extension 解析演讲人 宋少华北京晟数科技&讲师Extension 运行框架Extension 运行的框架Extension 构成解析Extension 构成文件内容解析Extension 创建示例使用 CREATE EXTENSTION 创建扩展Extension 调用 hook 函数在 Extension 中使用 hook 函数CONTENTPART 01Extension 运行框架Extension 运行框架Extension 分布在 PostgreSQL 源码目录下的 contrib 目录。PART 02Extension 模块解析Makefile文件这里

2、仅解释在一个扩展文件中的基本需求变量名称描述#表示一个注释MODULE_big用于从OJBS中的多个源文件构建的共享库名称OBJS编译源码的目标名称EXTENSION用于$EXTENSIONO.control 中的扩展名称DATA安装到$prefix/share/$MODULEDIR目录下的文件PGFILEDESC用于扩展描述PG_CONFIG用于指定pg_config命令PGXS用于得到扩展Makefile文件的位置include编译时使用的的额外的Makefile文件subdir用于定义扩展模块目录的路径top_builddir用于定义扩展模块所在目录的上级上目录C源码文件C源码文件中的必

3、要定义解析名称描述PG_MODULE_MAGICPG的魔法值宏定义(在 fmgr.h 中声明)Datum表示一个无符号的整数变量(在 postgres.h 中定义 typedef uintptr_t Datum)PG_FUNCTION_INFO_V1动态加载宏定义(在 fmgr.h 中声明)PG_FUNCTION_ARGS用来在函数内部使用fcinfo来访问函数参数和元数据信息(在fmgr.h中声明)extern void _PG_init(void);声明一个函数原型，该函数主要是针对PostgreSQL提供的hook函数进行调用control文件control 文件的必要定义解析控制文件在

4、扩展中属于可选部分名称描述comment对当前扩展注释default_version指定当前扩展版本module_pathname当前扩展安装路径relocatable=true是否启用可重定位sql 文件sql 文件在 PostgreSQL 扩展中属于可选部分，只有当源码文件.c 中定义了相关函数，可在该部分编写 sql 语句，以调用创建PostgreSQL 支持的 C 语言函数。PART 03使用 CREATE EXTENSTION 创建扩展编写源码 C 文件#include postgres.h#include fmgr.h/定义魔法值PG_MODULE_MAGIC;/动态加载宏定义声明

5、函数PG_FUNCTION_INFO_V1(n_sum);/使用Datum 结构返回一个整数Datum n_sumn_sum(PG_FUNCTION_ARGS)uint32 first_val=PG_GETARG_UINT32(0 0);uint32 end_val=PG_GETARG_UINT32(1 1);uint32 sum =0 0;sum=(first_val+end_val)*end_val)/2 2;PG_RETURN_UINT32(sum);编写 Makefile 文件#求前 n 项和MODULE_big=n_sumOBJS=$(WIN32RES)n_sum.oEXTENSIO

6、N=n_sumDATA=n_sum-1.01.0.sqlPGFILEDESC=return first value add end valueifdef USE_PGXSPG_CONFIG=pg_configPGXSPGXS:=$(shell$(PG_CONFIG)-pgxs)include$(PGXS)elseelsesubdir=contrib/n_sumtop_builddir=./.include$(top_builddir)/src/Makefile.globalinclude$(top_srcdir)/contrib/contrib-global.mkendif编写控制文件root