CLOSE

CLOSE — cerrar un cursor

Synopsis

CLOSE { name | ALL }

Descripción

CLOSE libera los recursos asociados con un cursor abierto. Después de cerrar el cursor, no se permiten operaciones posteriores en él. Un cursor debe cerrarse cuando ya no se necesite.

Cada cursor abierto que no sea de tipo «holdable» (retenible) se cierra implícitamente cuando una transacción se termina mediante COMMIT o ROLLBACK. Un cursor de tipo «holdable» se cierra implícitamente si la transacción que lo creó se aborta mediante ROLLBACK. Si la transacción creadora se confirma con éxito, el cursor de tipo «holdable» permanece abierto hasta que se ejecute un CLOSE explícito o el cliente se desconecte.

Parámetros

name

El nombre de un cursor abierto que se desea cerrar.

ALL

Cierra todos los cursores abiertos.

Notas

PostgreSQL no tiene una instrucción de cursor OPEN explícita; se considera que un cursor está abierto cuando se declara. Usa la instrucción DECLARE para declarar un cursor.

Puedes ver todos los cursores disponibles consultando la vista de sistema pg_cursors.

Si un cursor se cierra después de un punto de guardado (savepoint) que luego se revierte, el CLOSE no se revierte; es decir, el cursor permanece cerrado.

Ejemplos

Cerrar el cursor liahona:

CLOSE liahona;

Compatibilidad

CLOSE cumple totalmente con el estándar SQL. CLOSE ALL es una extensión de PostgreSQL.

Consulte también

DECLARE, FETCH, MOVE