SPI_cursor_open

Name

SPI_cursor_open -- 设置一个使用 SPI_prepare 创建的规划的游标

Synopsis

SPI_cursor_open(name,
plan,
values,
nulls)

输入

char *name

邮差的名字,或者是 NULL -- 让系统选择一个名字

void *plan

执行规划

Datum *values

实际参数值

char *nulls

描述哪个参数是 NULL 的数组

n 表示 NULL (忽略 values[] 项)
空白表示非 NULL (values[] 项是非法的)

输出

邮差

指向包含游标的邮差名字,或者是出错时的 NULL

描述

SPI_cursor_open 设置一个可以执行由 SPI_prepare 准备的 规划的游标(在内部,实际是一个邮差).

使用游标操作,而不是直接执行规划有两个好处. 首先,我们可以每次检索少量的结果行.第二,一个邮差可以在当前 过程之外存活(实际上,它可以一直存活到当前事务的结尾). 向过程的调用者返回邮差的名字给我们提供了一个返回结果集的方法.

Usage

如果 nulls 是 NULL,那么 SPI_cursor_open 假设所有参数都是 NOT NULL.