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命令相同。像往常一样，这提供了灵活性，因此查询计划可以在不同执行之间变化（见Section 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，因为游标的滚动行为已经确定。

使用位置或命名记号可以传递参数值。在位置记号中，所有参数都必须按照顺序指定。在命名记号中，每一个参数的名字使用:=或=>与参数表达式分隔。类似于Section 4.3中描述的调用函数，也允许混合位置和命名记号。

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

OPEN curs2;
OPEN curs3(42);
OPEN curs3(key := 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不一样，FETCH仅允许整数常量）。除非游标被使用SCROLL选项声明或打开，否则要求反向移动的direction值很可能会失败。

cursor必须是一个引用已打开游标 portal 的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关闭打开游标所基于的 portal。这样就可以在事务结束之前提前释放资源，或者释放该游标变量以便再次打开。

一个示例：

CLOSE curs1;

PL/pgSQL函数可以向调用者返回游标。这对于返回多行或多列，特别是非常大的结果集时很有用。要做到这一点，函数需要打开游标，并把游标名返回给调用者（或者直接使用调用者指定或已知的 portal 名称来打开游标）。随后调用者就可以从该游标中提取行。游标既可以由调用者关闭，也会在事务结束时自动关闭。

游标使用的 portal 名称既可以由程序员指定，也可以自动生成。要指定 portal 名称，只需在打开refcursor变量之前给它赋一个字符串值。OPEN会把该refcursor变量的字符串值用作底层 portal 的名称。不过，如果refcursor变量为 null，OPEN就会自动生成一个与任何现有 portal 都不冲突的名称，并把它赋回给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;

-- 需要在一个事务中使用游标。
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;

-- 需要在一个事务中使用游标。
BEGIN;

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

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