$listSessions

Definition定义

$listSessions

Lists all sessions stored in the system.sessions collection in the config database. 列出存储在配置数据库的system.sessions集合中的所有会话。These sessions are visible to all members of the MongoDB deployment.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. 实例将定期将其缓存的会话同步到配置数据库中的system.sessions集合，此时$listSessions和部署的所有成员都可以看到这些会话。Until the session record exists in the system.sessions collection, you can only list the session via the $listLocalSessions operation.在system.sessions集合中存在会话记录之前，只能通过$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: { } } ] )