$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 mongod ou mongos , o registro da sessão existe inicialmente apenas na memória da 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 config system.sessions banco de dados do , quando, eles são visíveis para $listSessions e todos os membros da implantação. Até que o registro de 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: { } } ] )