Name
SPI_cursor_open -- 用
SPI_prepare 创建的规划设置一个游标
Synopsis
Portal SPI_cursor_open(const char * name, void * plan, Datum * values, const char * nulls)
描述
SPI_cursor_open 设置一个游标(内部叫入口),这个游标可以执行 SPI_prepare 准备的规划。
使用游标而不是直接执行规划有两个优点。首先,结果行可以每次检索一小部分,
避免那些返回大量数据行的查询造成的内存缺乏。
第二,一个入口可以在当前过程之外存货(实际上,它可以活到当前事务的结尾)。
给过程的调用者返回一个入口名是一种返回行结果集的方法。
参数
- const char * name
入口的名字,或者是用 NULL,让系统选择一个名字
- void * plan
执行规划(SPI_prepare 返回的东西)
- Datum * values
实际参数值
- const char *nulls
一个描述那些参数是空值的数组。n 表示一个空值(在 values 里对应的元素将被忽略);
一个空白表示一个非空值(在 values 里的条目是有效的)。
如果 nulls 是 NULL 那么 SPI_cursor_open 假设没有参数是空。
返回值
指向包含入口游标的指针,或者是错误的时候是 NULL。