$listLocalSessions

Esta versión de la documentación se archivó y ya no se admite. Para actualizar tu implementación de 5.0, consulta el Procedimientos de actualización de MongoDB.6.0

Definición

$listLocalSessions

Novedades en la versión 3.6.

Enumera las sesiones almacenadas en caché en la memoria por el mongod o mongos instancia.

Importante

Cuando un usuario crea una sesión en una instancia mongod o mongos, el registro de la sesión existe inicialmente solo en memoria en la instancia; es decir, el registro es local a la instancia. Periódicamente, la instancia sincronizará sus sesiones almacenadas en caché con la colección system.sessions en la base de datos config, momento en el cual estarán visibles para los miembros de $listSessions y todos los miembros del implementación. Hasta que el registro de la sesión exista en la colección system.sessions, sólo puedes listar la sesión a través de la operación $listLocalSessions.

La operación $listLocalSessions utiliza el método db.aggregate() y no el db.collection.aggregate().

Para ejecutar, debe ser la primera etapa del $listLocalSessions proceso.

La etapa tiene la siguiente sintaxis:

{ $listLocalSessions: <document> }

La etapa $listLocalSessions toma un documento con uno de los siguientes contenidos:

Campo	Descripción
`{ }`	Si se ejecuta con control de acceso, devuelve todas las sesiones para el usuario autenticado actual. Si se ejecuta sin control de acceso, se devuelven todas las sesiones.
`{ users: [ { user: <user>, db: <db> }, ... ] }`	Devuelve todas las sesiones de los usuarios especificados. Si se ejecuta con control de acceso, el usuario autenticado debe tener privilegios con `listSessions` la acción en el clúster para listar las sesiones de otros usuarios.
`{ allUsers: true }`	Devuelve todas las sesiones de todos los usuarios. Si se ejecuta con control de acceso, el usuario autenticado debe tener privilegios con la acción `listSessions` en el clúster.

Restricciones

$listLocalSessions no se permite en las transacciones.

Ejemplos

Listar todas las sesiones locales

Desde la memoria caché de sesiones en memoria de la instancia conectada mongod / mongos, la siguiente operación de agregación enumera todas las sesiones:

Nota

Si se ejecuta con control de acceso, el usuario actual debe tener privilegios con la acción en el listSessions clúster.

db.aggregate( [  { $listLocalSessions: { allUsers: true } } ] )

Lista de todas las sesiones locales para los usuarios especificados

Desde la caché en memoria de la instancia mongod / mongos conectada, la siguiente operación de agregación enumera todas las sesiones para el usuario myAppReader@test especificado:

Nota

Si se ejecuta con control de acceso y el usuario actual no es el usuario especificado, el usuario actual debe tener privilegios con la acción en el listSessions clúster.

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

Listar todas las sesiones locales para el usuario actual

Desde la memoria caché en memoria de la instancia mongod / mongos conectada, la siguiente operación de agregación enumera todas las sesiones del usuario actual si se ejecuta con control de acceso:

db.aggregate( [ { $listLocalSessions: { } } ] )

Si se ejecuta sin control de acceso, la operación muestra todas las sesiones locales.

Volver

$limit

$listSessions