pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
SPI_cursor_open — 使用由 SPI_prepare 创建的 计划建立一个游标
Portal SPI_cursor_open(const char *name, void *plan, Datum *values, const char *nulls)
SPI_cursor_open 建立一个游标(在内部是一个 portal),该游标将执行由 SPI_prepare 准备好的 一个计划。
使用游标而不是直接执行该计划有两个好处。首先,可以一次只取出少量 结果行,从而避免对返回大量行的查询耗尽内存。其次,一个 portal 可以比当前的过程存活更久(实际上,它可以一直存活到当前事务结束)。 把 portal 的名称返回给该过程的调用者,就提供了一种把行集作为 结果返回的方法。
const char * nameportal 的名称,或为NULL以让系统选择名称
void * plan执行计划(由 SPI_prepare 返回)
Datum * values实际参数值
const char *nulls一个描述哪些参数为空值的数组。 n 表示空值(values 中的对应项 会被忽略);空格表示非空值(values 中的对应项 有效)。如果 nulls 为 NULL,则 SPI_cursor_open 假定没有参数为空值。
指向包含该游标的 portal 的指针,出错时为 NULL
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。