D.11.6 DISCONNECT

Name

DISCONNECT -- terminate a database connection

Synopsis

DISCONNECT connection_name

DISCONNECT [ CURRENT ]

DISCONNECT DEFAULT

DISCONNECT ALL

Description

DISCONNECT closes a connection (or all connections) to the database.

Parameters

connection_name: A database connection name established by the CONNECT command.

CURRENT: Close the "current" connection, which is either the most recently opened connection, or the connection set by the SET CONNECTION command. This is also the default if no argument is given to the DISCONNECT command.

DEFAULT: Close the default connection.

ALL: Close all open connections.

Examples

    EXEC SQL CONNECT TO testdb AS DEFAULT USER testuser END-EXEC.
    EXEC SQL CONNECT TO testdb AS con1 USER testuser END-EXEC.
    EXEC SQL CONNECT TO testdb AS con2 USER testuser END-EXEC.
    EXEC SQL CONNECT TO testdb AS con3 USER testuser END-EXEC.

*   close con3
    EXEC SQL DISCONNECT CURRENT END-EXEC.
*   close DEFAULT
    EXEC SQL DISCONNECT DEFAULT END-EXEC.
*   close con2 and con1
    EXEC SQL DISCONNECT ALL END-EXEC.

Compatibility

DISCONNECT is specified in the SQL standard.