/ /

$listSessions (etapa de agregación)

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 instanciamongodomongos, el registro de la sesión existe inicialmente solo en memoria en la instancia; es decir, el registro es local para la instancia. Periódicamente, la instancia sincronizará sus sesiones en caché con la colecciónsystem.sessionsen la base de datos config, momento en el cual serán visibles para $listSessions y todos los miembros de la implementación. Hasta que el registro de sesión exista en la system.sessions colección, solo se puede listar la sesión mediante la $listLocalSessions operación.

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

Listar todas las sesiones

De la colección, la siguiente operación de agregación enumera todas las system.sessions sesiones:

Nota

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

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

Listar todas las sesiones para los usuarios especificados

De la colección, la siguiente operación de agregación enumera todas las sesiones del system.sessions 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.

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

Listar todas las sesiones del usuario actual

De la colección, la siguiente operación de agregación system.sessions enumera todas las sesiones del usuario actual si se ejecuta con control de acceso:

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

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

Para usar el controlador Node.js de MongoDB y añadir una $listSessions etapa a una canalización de agregación, utilice el $listSessions operador en un objeto de canalización. Ejecute la canalización en la system.sessions colección.

Listar todas las sesiones

La siguiente operación de agregación enumera todas las sesiones:

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

Nota

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

Listar todas las sesiones para los usuarios especificados

La siguiente operación de agregación enumera todas las sesiones del usuario especificado myAppReader@test:

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;

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.

Listar todas las sesiones del usuario actual

Si se ejecuta con control de acceso, la siguiente operación de agregación enumera todas las sesiones del usuario actual:

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

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

Volver

$listSearchIndexes

$lookup