OPEN variável_de_cursor_não_vinculada
     [ [ NO ] SCROLL ]
     FOR consulta;

A variável de cursor é aberta, e recebe a consulta especificada para executar. O cursor não pode já estar aberto, devendo ter sido declarado como uma variável de cursor não vinculada (ou seja, como uma simples variável refcursor). A consulta deve ser um comando SELECT, ou algo que retorne linhas (como o EXPLAIN). A consulta é tratada da mesma maneira que os demais comandos SQL no PL/pgSQL: Os nomes das variáveis do PL/pgSQL são substituídos, e o plano de consulta é armazenado em cache para uma possível reutilização. Quando uma variável do PL/pgSQL é substituída na consulta do cursor, o valor substituído é o que ela tinha no momento do OPEN; alterações subsequentes na variável não afetam o comportamento do cursor. As opções SCROLL e NO SCROLL têm os mesmos significados que para o cursor vinculado.

Exemplo:

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

OPEN variável_de_cursor_não_vinculada
     [ [ NO ] SCROLL ]
     FOR EXECUTE cadeia_de_caracteres_da_consulta
     [ USING expressão [, ... ] ];

A variável de cursor é aberta, e recebe a consulta especificada para executar. O cursor não pode já estar aberto, devendo ter sido declarado como uma variável de cursor não vinculada (ou seja, como uma simples variável refcursor). A consulta é especificada como uma expressão de cadeia de caracteres, da mesma forma que no comando EXECUTE. Como de costume, isto dá flexibilidade para que o plano de consulta possa variar de uma execução para outra (veja Cache de plano), e também significa não ser feita a substituição de variável na cadeia de caracteres do comando. Como acontece com o EXECUTE, os valores dos parâmetros podem ser inseridos no comando dinâmico através de format() e USING. As opções SCROLL e NO SCROLL têm os mesmos significados que para o cursor vinculado.

Exemplo:

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

Neste exemplo, o nome da tabela é inserido na consulta através da função format(). O valor de comparação para col1 é inserido por meio de um parâmetro da cláusula USING, portanto, não precisa de delimitadores.

OPEN variável_de_cursor_vinculado
     [ ( [ nome_do_argumento { := | => } ] valor_do_argumento [, ...] ) ];

Esta forma do OPEN é usada para abrir uma variável de cursor cuja consulta foi vinculada a ela quando foi declarada. O cursor não pode já estar aberto. A lista de expressões de valor de argumento deve aparecer se, e somente se, o cursor tiver sido declarado aceitando argumentos. Estes valores são substituídos na consulta.

O plano de consulta para um cursor vinculado é sempre considerado armazenável em cache; não há equivalente a EXECUTE neste caso. Note que SCROLL e NO SCROLL não podem ser especificados no OPEN, porque o comportamento de rolagem do cursor já foi determinado.

Os valores dos argumentos podem ser passados usando a notação posicional ou notacional. Na notação posicional, todos os argumentos são especificados em ordem. Na notação notacional, o nome de cada argumento é especificado usando := ou => para separá-lo da expressão do argumento. De forma semelhante às chamadas de funções, descritas em Chamadas de função, também é permitido misturar notação posicional e notacional.

Exemplos (usando os exemplos de declaração de cursor mostrados acima):

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

Como é feita a substituição de variável na consulta de um cursor vinculado, existem duas maneiras de passar valores para o cursor: seja com um argumento explícito para o OPEN, ou implicitamente referenciando uma variável do PL/pgSQL na consulta. Entretanto, apenas as variáveis declaradas antes da declaração do cursor vinculado serão substituídas nele. Nos dois casos, o valor a ser passado é determinado no momento do OPEN. Por exemplo, outra maneira de obter o mesmo efeito do exemplo curs3 acima é

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

FETCH [ direção { FROM | IN } ] cursor INTO destino;

FETCH recupera a próxima linha do cursor (na direção indicada) para o destino, que pode ser uma variável tipo-linha, uma variável tipo-registro ou uma lista de variáveis ​​simples separadas por vírgulas, assim como SELECT INTO. Se não houver nenhuma linha adequada, o destino será definido como NULL(s). Assim como no SELECT INTO, a variável especial FOUND pode ser verificada para ver se uma linha foi obtida ou não. Caso nenhuma linha seja obtida, o cursor será posicionado após a última linha ou antes da primeira, dependendo da direção do movimento.

A cláusula direção pode ser qualquer uma das variantes permitidas no comando SQL FETCH, exceto aquelas que podem buscar mais de uma linha; ou seja, pode ser NEXT, PRIOR, FIRST, LAST, ABSOLUTE contador, RELATIVE contador, FORWARD, ou BACKWARD. Omitir a direção é idêntico a especificar NEXT. Nas formas usando contador, o contador pode ser qualquer expressão que resulte em um valor inteiro (diferentemente do comando FETCH do SQL, que permite apenas uma constante inteira). Os valores de direção que exigem mover para trás provavelmente falharão, a menos que o cursor tenha sido declarado ou aberto com a opção SCROLL.

cursor deve ser o nome de uma variável do tipo refcursor que faz referência a um portal de cursor aberto.

Exemplos:

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 [ direção { FROM | IN } ] cursor;

O comando MOVE reposiciona o cursor sem recuperar nenhum dado. O comando MOVE funciona como o comando FETCH, exceto que ele apenas reposiciona o cursor e não retorna a linha para a qual foi movido. A cláusula direção pode ser qualquer uma das variantes permitidas no comando FETCH do SQL, incluindo aquelas que podem buscar mais de uma linha; o cursor é posicionado na última destas linhas. (Entretanto, no caso em que a cláusula direção é simplesmente uma expressão de contador sem palavra-chave está obsoleta no PL/pgSQL. Esta sintaxe é ambígua no caso em que a cláusula direção é omitida por completo., e, portanto, poderá falhar se o contador não for uma constante.) Assim como no SELECT INTO, a variável especial FOUND pode ser verificada para ver se havia uma linha para a qual se mover. Caso não exista tal linha, o cursor será posicionado após a última linha, ou antes da primeira, dependendo da direção do movimento.

Exemplos:

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

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

Quando o cursor é posicionado em uma linha da tabela, esta linha pode ser atualizada ou excluída usando o cursor para identificar a linha. Existem restrições sobre o que pode ser a consulta do cursor (em particular, nenhum agrupamento), sendo melhor usar FOR UPDATE no cursor. Para obter mais informações, consulte a página de referência da instrução DECLARE.

Exemplo:

UPDATE foo SET dataval = myval WHERE CURRENT OF curs1;

CLOSE cursor;

CLOSE fecha o portal subjacente a um cursor aberto. Pode ser usado para liberar recursos antes do final da transação, ou para liberar a variável do cursor para ser aberta novamente.

Exemplo:

CLOSE curs1;

As funções PL/pgSQL podem retornar cursores para quem efetuou a chamada, os quais são úteis para retornar várias linhas ou colunas, principalmente em conjuntos de resultados muito grandes. Para fazer isto, a função abre o cursor e retorna o nome do cursor para quem efetuou a chamada (ou apenas abre o cursor usando um nome de portal especificado, ou conhecido por quem efetuou a chamada). Quem efetuou a chamada poderá então buscar as linhas do cursor, que poderá ser fechado por quem efetuou a chamada, ou será fechado automaticamente quando a transação for fechada.

O nome do portal usado para o cursor pode ser especificado pelo programador, ou gerado automaticamente. Para especificar um nome de portal, deve-se apenas atribuir uma cadeia de caracteres à variável refcursor antes de abri-la. O valor da cadeia de caracteres da variável refcursor será usado por OPEN como o nome do portal subjacente. Entretanto, se o valor da variável refcursor for nulo (como é por padrão), então o OPEN irá gerar automaticamente um nome que não entra em conflito com nenhum portal existente, e o atribuirá à variável refcursor.

O exemplo a seguir mostra uma maneira pela qual quem chama pode fornecer o nome de um cursor:

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;

O exemplo a seguir utiliza a geração automática de nomes de cursor:

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

-- é necessário estar em uma transação para usar cursores
BEGIN;
SELECT reffunc2();

      reffunc2
--------------------
 <unnamed portal 1>
(1 linha)

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

O exemplo a seguir mostra uma maneira de retornar vários cursores a partir de uma única função:

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;

-- é necessário estar em uma transação para usar cursores
BEGIN;

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

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