Close
Closes a previously defined cursor object.
Synopsis
CLOSE cursor
Parameters
cursor
The name of a currently open cursor that you wish to close.
Results
CLOSE
The message returned when the cursor is successfully closed.
NOTICE: PerformPortalClose: portal "
cursor
" not found
The notice returned if the specified
cursor
is either not declared, or not open.
Description
The CLOSE
command closes an open cursor and frees the resources it was
using. Cursors should always be closed after they are no longer needed. Once a cursor is
closed, further operations are not allowed on it.
Note
Executing a COMMIT
or ROLLBACK
terminates the
current transaction, closing all open cursors.
Examples
The following example opens a transaction, declares the cur_publishers
cursor, and closes it:
booktown=# BEGIN; BEGIN booktown=# DECLARE cur_publishers CURSOR FOR SELECT * FROM publishers; SELECT booktown=# CLOSE cur_publishers; CLOSE
Get Practical PostgreSQL now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.