PostgreSQL 13.1 中文入门教程 PostgreSQL SPI_scroll_cursor_move

2024-02-25 开发教程 PostgreSQL 13.1 中文入门教程 匿名 1

SPI_scroll_cursor_move — 移动一个游标

大纲

void SPI_scroll_cursor_move(Portal portal, FetchDirection direction,
long count)

描述

SPI_scroll_cursor_move在一个游标中跳过 一定数量的行。这等效于 SQL 命令MOVE

参数

Portal portal

包含该游标的 portal

FetchDirection direction

FETCH_FORWARDFETCH_BACKWARDFETCH_ABSOLUTE或者 FETCH_RELATIVE之一

long count

FETCH_FORWARD或者 FETCH_BACKWARD方式中要移动的行数; FETCH_ABSOLUTE方式中要移动到的绝对行号; FETCH_RELATIVE方式中要移动到的相对行号

返回值

成功时,就像在SPI_execute中会设置 SPI_processedSPI_tuptable被设置为NULL, 因为这个函数不需要返回行。

注解

参数directioncount的详细解释请见 SQL FETCH命令。

如果该游标的计划不是用CURSOR_OPT_SCROLL选项创建的,除FETCH_FORWARD之外的方向值会 失败。