Chapter 22. 服务器编程接口

Table of Contents
22.1. 接口函数
SPI_connect — 把你的过程与 SPI 管理器连接起来.
SPI_finish — 把你的过程与 SPI 管理器断开.
SPI_exec — 创建一个执行规划 (分析器+规划器+优化器)并且执行一个查询.
SPI_prepare — 将你的过程与 SPI 管理器连接.
SPI_saveplan — 保存传递进来的规划
SPI_execp — 执行一个从 SPI_saveplan来的规划
22.2. 接口支持函数
SPI_copytuple — 把元组的拷贝放到上层执行器环境
SPI_modifytuple — 元组被修改的关系
SPI_fnumber — 查找声明的字段的字段号
SPI_fname — 找出指明字段的字段名
SPI_getvalue — 返回指明的字段的字符串值
SPI_getbinval — 返回指明字段的二进制数值
SPI_gettype — 返回指明字段的类型名
SPI_gettypeid — 返回指明字段的类型 OID
SPI_getrelname — 返回指明关系的名称
SPI_palloc — 在上层执行器环境中分配存储器
SPI_repalloc — 重新在执行器上层环境中分配存储器
SPI_pfree — 在上层执行器环境中释放存储器
22.3. 存储器管理
22.4. 数据改变的可视性
22.5. 例子

服务器编程接口SPI) 给我们在用户定义的C函数里面运行 SQL 查询的能力. 其他过程语言(PL)给我们一些实现这些功能的可选的手段.

实际上,SPI 只是一套用于访问分析器,规划器,优化器和执行器 的本机接口函数. SPI 同样做一些存储器管理工作.

了避免混淆,我们将使用函数(function) 来代表SPI接口函数, 用过程(procedure) 代表用户用 SPI 定义 C 函数.

使用 SPI 的过程都是由执行器 调用的. SPI 调用随后递归地调用执行器以运行查询. 当执行器被递归地调用的时候,它本身也可以调用那些做了 SPI 调用的过程.

注意,如果在你的过程里执行查询时,事务退出了,那么控制不会返回到你的过程中. 相反,所有工作都将回卷并且服务器将等待客户端的另一个命令.这一点将在以后的版本中修正.

其他限制是不能执行 BEGIN,END 和 ABORT (交易控制语句)和游标操作. 这些同样在将来的版本中要被修改.

如果执行成功了,SPI 函数返回一个非负结果 (或者通过返回一个整数值或放在 SPI_result 全局变量, 象下面描述的那样).出错时,返回一个负数或 NULL 结果.

22.1. 接口函数