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 变量）。查询指定为 String 表达式，与 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() 将表名插入查询中。通过 USING 参数插入 col1 的比较值，因此不需要引号。

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

此形式的 OPEN 用于打开在声明它时已查询绑定到它的游标变量。游标不能已打开。当且仅当声明游标会采用参数时，必须出现实际参数值表达式的列表。这些值将替换查询中。

绑定游标的查询计划始终被认为是可缓存的；在这种情况下，没有 EXECUTE 等价项。请注意，由于游标的滚动行为已确定，因此无法在 OPEN 中指定 SCROLL 和 NO SCROLL。

可以使用 位置 或 已命名 符号法传递参数值。在位置符号法中，所有参数按顺序指定。在已命名符号法中，每个参数的名称使用 := 指定，以将其与参数表达式分开。类似于调用函数（在 第 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(s)。与 SELECT INTO一样，特殊变量 FOUND 可以进行检测，以查看是否获取到了行。如果没有获取行，游标将根据移动方向置于最后一行或第一行之后。

direction 子句可以是 SQL FETCH 命令中允许的任何变体，除了可以获取多行内容的变体，即可以是 NEXT、PRIOR、FIRST、LAST、ABSOLUTE count、RELATIVE count、FORWARD或 BACKWARD。省略 direction 与指定 NEXT相同。在使用 count 的形式中，count 可以是任何整数值表达式（不同于仅允许整形常量的 SQL FETCH 命令）。如果游标未使用 SCROLL 选项声明或打开，则需要向后移动的 direction 值很可能失败。

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;