$listSessions

Definition定义

$listSessions

Lists all sessions stored in the system.sessions collection in the config database. These sessions are visible to all members of the MongoDB deployment.列出配置数据库中system.sessions集合中存储的所有会话。这些会话对MongoDB部署的所有成员都可见。

Important重要

When a user creates a session on a mongod or mongos instance, the record of the session initially exists only in-memory on the instance; i.e. the record is local to the instance. 当用户在mongod或mongos实例上创建会话时，会话的记录最初仅存在于实例的内存中；即，该记录是实例的本地记录。Periodically, the instance will sync its cached sessions to the system.sessions collection in the config database, at which time, they are visible to $listSessions and all members of the deployment. 实例将定期将其缓存会话同步到config数据库中的system.sessions集合，此时，它们对$listSessions和部署的所有成员可见。Until the session record exists in the system.sessions collection, you can only list the session via the $listLocalSessions operation.在$listLocalSessions集合中存在会话记录之前，只能通过$listLocalSessions操作列出会话。

To run $listSessions, it must be the first stage in the pipeline.要运行$listSessions，它必须是管道中的第一个阶段。

The stage has the following syntax:阶段语法如下：

{ $listSessions: <document> }

The $listSessions stage takes a document with one of the following contents:$listSessions阶段接受具有以下内容之一的文档：

Field字段	Description描述
{ }	If running with access control, returns all sessions for the current authenticated user.如果使用访问控制运行，则返回当前已验证用户的所有会话。 If running without access control, returns all sessions.如果在没有访问控制的情况下运行，则返回所有会话。
{ users: [ { user: <user>, db: <db> }, ... ] }	Returns all sessions for the specified users. 返回指定用户的所有会话。If running with access control, the authenticated user must have privileges with listSessions action on the cluster to list sessions for other users.如果使用访问控制运行，则经过身份验证的用户必须具有集群上listSessions操作的权限，才能列出其他用户的会话。
{ allUsers: true }	Returns all sessions for all users. 返回所有用户的所有会话。If running with access control, the authenticated user must have privileges with listSessions action on the cluster.如果使用访问控制运行，则经过身份验证的用户必须具有集群上listSessions操作的权限。

Restrictions限制

$listSessions is not allowed in transactions.事务中不允许使用$listSessions。

Examples示例

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

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

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