OPEN unbound_cursorvar [ [ NO ] SCROLL ] FOR query;

打开游标变量并为其指定要执行的查询。游标不能已经打开，并且必须已声明为未绑定游标变量（即，作为简单 refcursor 变量）。查询必须是 SELECT，或其他返回行的命令（如 EXPLAIN）。查询的处理方式与 PL/pgSQL 中的其他 SQL 命令相同：替换 PL/pgSQL 变量名称，并将查询计划缓存以备将来可能重用。当将 PL/pgSQL 变量替换到游标查询中时，替换的值是在 OPEN 时的值；之后对变量的更改不会影响游标的行为。 SCROLL 和 NO SCROLL 选项与绑定游标的含义相同。

一个示例

OPEN curs1 FOR SELECT * FROM foo WHERE key = mykey;

OPEN unbound_cursorvar [ [ NO ] SCROLL ] FOR EXECUTE query_string
                                     [ USING expression [, ... ] ];

打开游标变量并为其指定要执行的查询。游标不能已经打开，并且必须已声明为未绑定游标变量（即，作为简单 refcursor 变量）。查询指定为字符串表达式，方式与 EXECUTE 命令相同。通常，这提供了灵活性，以便查询计划可以从一次运行到下次运行有所不同（参见 第 41.11.2 节），这也意味着不会对命令字符串进行变量替换。与 EXECUTE 相同，可以通过 format() 和 USING 将参数值插入到动态命令中。 SCROLL 和 NO SCROLL 选项与绑定游标的含义相同。

一个示例

OPEN curs1 FOR EXECUTE format('SELECT * FROM %I WHERE col1 = $1',tabname) USING keyvalue;

在本例中，表名通过 format() 插入到查询中。 col1 的比较值通过 USING 参数插入，因此不需要引用。

OPEN bound_cursorvar [ ( [ argument_name := ] argument_value [, ...] ) ];

此形式的 OPEN 用于打开一个游标变量，该游标变量的查询在声明时已绑定到它。游标不能已经打开。如果并且仅当游标被声明为接受参数时，必须出现实际参数值表达式的列表。这些值将被替换到查询中。

绑定游标的查询计划始终被视为可缓存的；在这种情况下，没有等效的 EXECUTE。请注意，SCROLL 和 NO SCROLL 不能在 OPEN 中指定，因为游标的滚动行为已确定。

参数值可以使用 位置 或 命名 符号传递。在位置符号中，所有参数都按顺序指定。在命名符号中，每个参数的名称使用 := 指定，用以将其与参数表达式分隔。与 第 4.3 节 中描述的调用函数类似，也允许混合使用位置符号和命名符号。

示例（这些示例使用上面的游标声明示例）

OPEN curs2;
OPEN curs3(42);
OPEN curs3(key := 42);

由于在绑定游标的查询上进行变量替换，因此实际上有两种方法可以将值传递到游标中：要么使用 OPEN 的显式参数，要么隐式地通过引用查询中的 PL/pgSQL 变量。但是，只有在声明绑定游标之前声明的变量才会被替换到其中。无论哪种情况，传递的值都是在 OPEN 时的值。例如，另一种获得与上面 curs3 示例相同效果的方法是

DECLARE
    key integer;
    curs4 CURSOR FOR SELECT * FROM tenk1 WHERE unique1 = key;
BEGIN
    key := 42;
    OPEN curs4;

FETCH [ direction { FROM | IN } ] cursor INTO target;

FETCH 从游标中检索下一行（在指示的方向上），并将其放入目标中，目标可以是行变量、记录变量或逗号分隔的简单变量列表，就像 SELECT INTO 一样。如果没有合适的行，则将目标设置为 NULL。与 SELECT INTO 一样，可以检查特殊变量 FOUND 来查看是否获取了行。如果没有获取行，则游标将定位在最后一行之后或第一行之前，具体取决于移动方向。

direction 子句可以是 SQL FETCH 命令中允许的任何变体，除了可以获取多行的变体；也就是说，它可以是 NEXT、PRIOR、FIRST、LAST、ABSOLUTE count、RELATIVE count、FORWARD 或 BACKWARD。省略 direction 等同于指定 NEXT。在使用 count 的形式中，count 可以是任何整数值表达式（与 SQL FETCH 命令不同，它只允许整数常量）。需要向后移动的 direction 值可能会失败，除非游标是在声明或打开时使用 SCROLL 选项声明的。

cursor 必须是引用打开游标门户的 refcursor 变量的名称。

示例

FETCH curs1 INTO rowvar;
FETCH curs2 INTO foo, bar, baz;
FETCH LAST FROM curs3 INTO x, y;
FETCH RELATIVE -2 FROM curs4 INTO x;

MOVE [ direction { FROM | IN } ] cursor;

MOVE 会重新定位游标，但不会检索任何数据。 MOVE 的工作原理类似于 FETCH 命令，只是它只重新定位游标，而不返回已移动到的行。 direction 子句可以是 SQL FETCH 命令中允许的任何变体，包括可以获取多行的变体；游标将定位到最后一行。（但是，如果 direction 子句只是一个 count 表达式，没有关键字，则在 PL/pgSQL 中已弃用。该语法与完全省略 direction 子句的情况模棱两可，因此如果 count 不是常量，则可能会失败。）与 SELECT INTO 一样，可以检查特殊变量 FOUND 来查看是否存在要移动的行。如果没有这样的行，则游标将定位在最后一行之后或第一行之前，具体取决于移动方向。

示例

MOVE curs1;
MOVE LAST FROM curs3;
MOVE RELATIVE -2 FROM curs4;
MOVE FORWARD 2 FROM curs4;

UPDATE table SET ... WHERE CURRENT OF cursor;
DELETE FROM table WHERE CURRENT OF cursor;

当游标定位在表行上时，可以使用游标来标识行，从而更新或删除该行。游标的查询存在一些限制（特别是不能进行分组），最好在游标中使用 FOR UPDATE。有关更多信息，请参见 DECLARE 参考页面。

一个示例

UPDATE foo SET dataval = myval WHERE CURRENT OF curs1;

CLOSE cursor;

CLOSE 会关闭打开的游标的底层门户。这可以用来在事务结束之前释放资源，或者释放游标变量以便再次打开。

一个示例

CLOSE curs1;

PL/pgSQL 函数可以将游标返回给调用方。这对于返回多行或多列很有用，尤其是在处理非常大的结果集时。要做到这一点，函数会打开游标并将游标名称返回给调用方（或者只是使用调用方指定或已知的门户名称打开游标）。然后，调用方可以从游标中获取行。游标可以由调用方关闭，也可以在事务关闭时自动关闭。

用于游标的门户名称可以由程序员指定或自动生成。要指定门户名称，只需在打开游标之前将字符串分配给 refcursor 变量即可。 refcursor 变量的字符串值将被 OPEN 用作底层门户的名称。但是，如果 refcursor 变量的值为空（默认情况下会为空），则 OPEN 会自动生成一个不会与任何现有门户冲突的名称，并将其分配给 refcursor 变量。

以下示例演示了一种调用方可以提供游标名称的方法

CREATE TABLE test (col text);
INSERT INTO test VALUES ('123');

CREATE FUNCTION reffunc(refcursor) RETURNS refcursor AS '
BEGIN
    OPEN $1 FOR SELECT col FROM test;
    RETURN $1;
END;
' LANGUAGE plpgsql;

BEGIN;
SELECT reffunc('funccursor');
FETCH ALL IN funccursor;
COMMIT;

以下示例使用自动游标名称生成

CREATE FUNCTION reffunc2() RETURNS refcursor AS '
DECLARE
    ref refcursor;
BEGIN
    OPEN ref FOR SELECT col FROM test;
    RETURN ref;
END;
' LANGUAGE plpgsql;

-- need to be in a transaction to use cursors.
BEGIN;
SELECT reffunc2();

      reffunc2
--------------------
 <unnamed cursor 1>
(1 row)

FETCH ALL IN "<unnamed cursor 1>";
COMMIT;

以下示例演示了一种从单个函数返回多个游标的方法

CREATE FUNCTION myfunc(refcursor, refcursor) RETURNS SETOF refcursor AS $$
BEGIN
    OPEN $1 FOR SELECT * FROM table_1;
    RETURN NEXT $1;
    OPEN $2 FOR SELECT * FROM table_2;
    RETURN NEXT $2;
END;
$$ LANGUAGE plpgsql;

-- need to be in a transaction to use cursors.
BEGIN;

SELECT * FROM myfunc('a', 'b');

FETCH ALL FROM a;
FETCH ALL FROM b;
COMMIT;