$listLocalSessions

Definição

$listLocalSessions

Novidade na versão 3.6.

Lista as sessões armazenadas em cache na memória pela instância mongod ou mongos .

Importante

Quando um usuário cria uma sessão em uma instância do mongod ou mongos, o registro da sessão inicialmente existe somente na memória na instância; ou seja, o registro é local para a instância. Periodicamente, a instância sincronizará suas sessões em cache com a coleção do system.sessions banco de dados do config, quando, eles são visíveis para $listSessions e todos os membros da implantação. Até que o registro da sessão exista na coleção system.sessions, você só pode listar a sessão por meio da operação $listLocalSessions.

A operação $listLocalSessions utiliza o método db.aggregate() e não o db.collection.aggregate().

Para executar $listLocalSessions, ele deve ser o primeiro estágio no pipeline.

O estágio tem a seguinte sintaxe:

{ $listLocalSessions: <document> }

O estágio $listLocalSessions recebe um documento com um dos seguintes conteúdos:

Campo	Descrição
{ }	Se estiver executando com controle de acesso, retorna todas as sessões para o usuário autenticado atual. Se estiver executando sem controle de acesso, retorne todas as sessões.
{ users: [ { user: <user>, db: <db> }, ... ] }	Retorna todas as sessões para os usuários especificados. Se estiver executando com controle de acesso, o usuário autenticado deverá ter privilégios com a ação listSessions no cluster para listar sessões para outros usuários.
{ allUsers: true }	Retorna todas as sessões para todos os usuários. Se estiver executando com controle de acesso, o usuário autenticado deverá ter privilégios com a ação listSessions no cluster.

Restrições

$listLocalSessions não é permitido em transações.

Exemplos

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

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

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