$listSessions

Definición

$listSessions

Enumera todas las sesiones almacenadas en el system.sessions Colección en la config base de datos. Estas sesiones son visibles para todos los miembros de la implementación de MongoDB.

Importante

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

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

La etapa tiene la siguiente sintaxis:

{ $listSessions: <document> }

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

Campo	Descripción
{ }	Si se ejecuta con control de acceso, devuelve todas las sesiones del usuario autenticado actual. Si se ejecuta sin control de acceso, devuelve 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 en el listSessions clúster.

Restricciones

$listSessions No está permitido en las transacciones.

Ejemplos

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: { } } ] )

const db = client.db("config");
const collection = db.collection("system.sessions");
const pipeline = [{ $listSessions: { allUsers: true } }];
const cursor = collection.aggregate(pipeline);
return cursor;

const db = client.db("config");
const collection = db.collection("system.sessions");
const pipeline = [
  { 
    $listSessions: { 
      users: [{ user: "myAppReader", db: "test"}] 
    } 
  }
];
const cursor = collection.aggregate(pipeline);
return cursor;

const db = client.db("config");
const collection = db.collection("system.sessions");
const pipeline = [{ $listSessions: {} }];
const cursor = collection.aggregate(pipeline);
return cursor;