CLOSE — close a cursor
CLOSE { name
| ALL }
CLOSE
frees the resources associated with an open cursor. After the cursor is closed, no subsequent operations are allowed on it. A cursor should be closed when it is no longer needed.
Every non-holdable open cursor is implicitly closed when a transaction is terminated by COMMIT
or ROLLBACK
. A holdable cursor is implicitly closed if the transaction that created it aborts via ROLLBACK
. If the creating transaction successfully commits, the holdable cursor remains open until an explicit CLOSE
is executed, or the client disconnects.
name
The name of an open cursor to close.
ALL
Close all open cursors.
PostgreSQL does not have an explicit OPEN
cursor statement; a cursor is considered open when it is declared. Use the DECLARE statement to declare a cursor.
You can see all available cursors by querying the pg_cursors
system view.
If a cursor is closed after a savepoint which is later rolled back, the CLOSE
is not rolled back; that is, the cursor remains closed.
Close the cursor liahona
:
CLOSE liahona;
CLOSE
is fully conforming with the SQL standard. CLOSE ALL
is a PostgreSQL extension.
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.