NEXT_CONNECTION 函数 [System]

返回下一个连接的标识号。

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

INT

connection-id 一个整数，通常是从上一个 NEXT_CONNECTION 调用返回。如果 connection-id 为 NULL，则 NEXT_CONNECTION 返回最近的连接 ID。
database-id 表示当前服务器上其中一个数据库的整数。如果不提供 database-id，将使用当前数据库。如果提供 NULL，则 NEXT_CONNECTION 返回下一个连接，不考虑数据库。

NEXT_CONNECTION 可用于枚举到数据库的连接。连接 ID 通常以单调递增顺序创建。此函数以相反顺序返回下一连接 ID。

要获取最近连接的连接 ID 值，请输入 NULL 作为 connection-id。要获取随后的连接，请输入上一返回值。不再有依循该顺序的连接时，此函数返回 NULL。

如果想要断开特定时间之前创建的所有连接，NEXT_CONNECTION 会有用处。不过，因为 NEXT_CONNECTION 是以相反顺序返回连接 ID，所以不会返回在启动函数后建立的连接。如果想要确保所有连接都断开，请避免在运行 NEXT_CONNECTION 前创建新连接。

以下语句返回当前数据库上第一个连接的标识符。该标识符是一个类似 10 的整数值。

SELECT NEXT_CONNECTION( NULL );

以下语句返回类似 5 的值。

SELECT NEXT_CONNECTION( 10 );

以下调用从当前数据库的指定 connection-id 开始，以相反顺序返回下一连接 ID。

SELECT NEXT_CONNECTION( connection-id );

以下调用从指定 connection-id 开始（不考虑数据库），以相反顺序返回下一连接 ID。

SELECT NEXT_CONNECTION( connection-id, NULL );

以下调用从指定数据库的指定 connection-id 开始，以相反顺序返回下一连接 ID。

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

以下调用返回第一个（最早的）连接（不考虑数据库）。

SELECT NEXT_CONNECTION( NULL, NULL );

以下调用返回指定数据库上的第一个（最早的）连接。

SELECT NEXT_CONNECTION( NULL, database-id );