$listSessions

在本页面

Definition

列出存储在config数据库的system.sessions集合中的所有会话。这些会话对 MongoDB 部署的所有成员都是可见的。

Important

当用户在mongod或mongos实例上创建会话时，该会话的记录最初仅存在于该实例的内存中。即记录是实例的本地记录。实例将定期将其缓存的会话同步到config数据库中的system.sessions集合，这时$listSessions和部署的所有成员都可以看到它们。在system.sessions集合中存在会话记录之前，您只能通过$listLocalSessions操作列出会话。

要运行$listSessions，它必须是管道中的第一阶段。

该阶段具有以下语法：

{ $listSessions: <document> }

$listLocalSessions阶段获取具有以下内容之一的文档：

{ } 如果使用访问控制运行，则返回当前已认证用户的所有会话。


如果运行时没有访问控制，则返回所有会话。
| { users: [ { user: <user>, db: <db> }, ... ] } |返回指定用户的所有会话。如果使用访问控制运行，则已认证的用户必须在群集上具有listSession操作的特权才能列出其他用户的会话。
| { allUsers: true } |返回所有用户的所有会话。如果使用访问控制运行，则已认证的用户必须在群集上具有listSession操作的特权。

Examples

列出所有会话

从system.sessions集合中，以下聚合操作列出了所有会话：

Note

如果使用访问控制运行，则当前用户必须对集群具有listSession操作的特权。

use config

db.system.sessions.aggregate( [  { $listSessions: { allUsers: true } } ] )

列出指定用户的所有会话

以下聚合操作从system.sessions集合中列出了指定用户myAppReader@test的所有会话：

Note

如果使用访问控制运行，并且当前用户不是指定的用户，则当前用户必须对集群具有listSession操作的特权。

use config

db.system.sessions.aggregate( [ { $listSessions: { users: [ {user: "myAppReader", db: "test" } ] } } ] )

列出当前用户的所有会话

从system.sessions集合中，以下聚合操作列出了使用访问控制运行的当前用户的所有会话(如果**)：

use config

db.system.sessions.aggregate( [ { $listSessions: { } } ] )

如果在没有访问控制的情况下运行，该操作将列出所有会话。

首页