CLOSE

Name

CLOSE -- close a cursor

Synopsis

CLOSE cursor

Description

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 open cursor is implicitly closed when a transaction is terminated by COMMIT or ROLLBACK.

Parameters

cursor

The name of an open cursor to close.

Diagnostics

CLOSE CURSOR

Message returned if the cursor is successfully closed.

WARNING: PerformPortalClose: portal "cursor" not found

This warning is given if cursor is not declared or has already been closed.

Notes

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.

Examples

Close the cursor liahona:

CLOSE liahona;

Compatibility

CLOSE is fully conforming with the SQL standard.