$listSessions

在本页面

Definition

  • $listSessions
    • 3.6 版的新功能。

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

Important

当用户在mongodmongos实例上创建会话时,该会话的记录最初仅存在于该实例的内存中。即记录是实例的本地记录。实例将定期将其缓存的会话同步到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: { } } ] )

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