OPEN unbound_cursor FOR SELECT ...;

该游标变量会被打开，并被赋予要执行的指定查询。该游标不能 已经处于打开状态，并且它必须已被声明为未绑定游标变量（即， 一个简单的 refcursor 变量）。SELECT 查询的处理方式与 PL/pgSQL 中的其他 SELECT 语句相同：替换 PL/pgSQL 变量名，并缓存查询计划 以备后续重用。

一个示例：

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

OPEN unbound_cursor FOR EXECUTE query_string;

该游标变量会被打开，并被赋予要执行的指定查询。该游标不能 已经处于打开状态，并且必须已被声明为未绑定游标变量（即， 一个简单的 refcursor 变量）。该查询以字符串 表达式的形式给出，这一点与 EXECUTE 命令相同。像往常一样，这提供了 灵活性，因此查询可以随每次运行而不同。

一个示例：

OPEN curs1 FOR EXECUTE 'SELECT * FROM ' || quote_ident($1);

OPEN bound_cursor [ ( argument_values ) ];

这种形式的 OPEN 用于打开一个在声明时就已经绑定查询 的游标变量。该游标不能已经处于打开状态。当且仅当该游标被 声明为接收参数时，才必须提供实际参数值表达式列表。这些值 会被替换到查询中。 已绑定游标的查询计划始终被视为可缓存；在这种情况下没有与 EXECUTE 对应的形式。

示例：

OPEN curs2;
OPEN curs3(42);

FETCH cursor INTO target;

FETCH 从游标中检索下一行到目标中，目标可以 是一个行变量、记录变量或者逗号分隔的简单变量列表，就像 SELECT INTO 一样。与 SELECT INTO 一样，可以检查特殊变量 FOUND 来看是否获得了一行。

示例：

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

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;
    RETURN;
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;