PostgreSQL 8.1 中文文档
PrevFast BackwardFast ForwardNext

SPI_cursor_open

Name

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

Synopsis

Portal SPI_cursor_open(const char * name, void * plan,
                       Datum * values, const char * nulls,
                       bool read_only)

描述

SPI_cursor_open 设置一个游标（内部叫入口）， 这个游标可以执行 SPI_prepare 准备的规划。 参数和对应的SPI_execute_plan参数具有相同的含义。

使用游标而不是直接执行规划有两个优点。首先，结果行可以每次检索一小部分， 避免那些返回大量数据行的查询造成的内存缺乏。 第二，一个入口可以在当前过程之外存货（实际上，它可以活到当前事务的结尾）。 给过程的调用者返回一个入口名是一种返回行结果集的方法。

参数

const char * name

入口的名字，或者是用 NULL，让系统选择一个名字

void * plan

执行规划（SPI_prepare 返回的东西）

Datum * values

一个实际参数值的数组。必须和规划的参数个数等长。

const char *nulls

一个描述那些参数是空值的数组。必须和规划的参数个数等长。 n 表示一个空值（在 values 里对应的元素将被忽略）； 一个空白表示一个非空值（在 values 里的条目是有效的）。

如果 nulls 是 NULL 那么 SPI_cursor_open 假设没有参数是空。

bool read_only

对于只读的执行为 true。

返回值

指向包含入口游标的指针，或者是错误的时候是 NULL。

成功时， SPI_processed 和 SPI_tuptable 的设置与 SPI_execute 同。

PrevHomeNext
SPI_execpUpSPI_cursor_find