$listSessions

Definição

$listSessions

Novidade na versão 3.6.

Lista todas as sessões armazenadas na coleção system.sessions no banco de banco de dados config . Essas sessões são visíveis para todos os membros do sistema do MongoDB .

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 .

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

O estágio tem a seguinte sintaxe:

{ $listSessions: <document> }

O estágio $listSessions 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

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

Exemplos

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