NEXT_CONNECTION(  connection-id  [, database-id ] )

INT

NEXT_CONNECTION can be used to enumerate the connections to a database. Connection IDs are generally created in monotonically increasing order. This function returns the next connection ID in reverse order.

To get the connection ID value for the most recent connection, enter NULL as the connection-id. To get the subsequent connection, enter the previous return value. The function returns NULL when there are no more connections in the order.

NEXT_CONNECTION is useful for disconnecting all the connections created before a specific time. However, because NEXT_CONNECTION returns the connection IDs in reverse order, connections made after the function is started are not returned. To ensure that all connections are disconnected, prevent new connections from being created before you run NEXT_CONNECTION.

Cloud note: Because of tenant database isolation rules, when this function is called in the cloud it returns only information about the current tenant database.

No privileges are required to execute this function to return the current connection ID. To execute this function for other connections, you must have either the SERVER OPERATOR, MONITOR, or DROP CONNECTION system privilege.

The following statement returns an identifier as an integer value for the first connection on the current database:

SELECT NEXT_CONNECTION( NULL );

The following statement returns an integer value like 5.

SELECT NEXT_CONNECTION( 10 );

The following call returns the next connection ID in reverse order from the specified connection-id on the current database:

SELECT NEXT_CONNECTION( connection-id );

The following call returns the next connection ID in reverse order from the specified connection-id, regardless of database:

SELECT NEXT_CONNECTION( connection-id, NULL );

The following call returns the next connection ID in reverse order from the specified connection-id on the specified database:

SELECT NEXT_CONNECTION( connection-id, database-id );

The following call returns the first or earliest connection, regardless of database:

SELECT NEXT_CONNECTION( NULL, NULL );

The following call returns the first or earliest connection on the specified database:

SELECT NEXT_CONNECTION( NULL, database-id );