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。请注意，不能在 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。与 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 命令中允许的任何变体，包括可以获取多行的变体；游标定位到最后一行。（但是，在 PL/pgSQL 中，direction 子句仅仅是一个没有关键字的 count 表达式的情况已被弃用。这种语法与完全省略 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 变量的值为 null（默认情况下是 null），则 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;