Menu Docs
Página inicial do Docs
/ /
Diagnóstico
Página inicial do Docs
/ /
Comandos de banco de dados
/
Diagnóstico
Página inicial do Docs
/
Desenvolvimento
/
Referência
/
Comandos de banco de dados
/
Diagnóstico

connectionStatus (comando de banco de dados)

Definição

connectionStatus

Retorna informações sobre a conexão atual, especificamente o estado dos usuários autenticados e suas permissões disponíveis.

Compatibilidade

Esse comando está disponível em implantações hospedadas nos seguintes ambientes:

  • MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

Observação

Este comando é aceito em todos os clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas a todos os comandos, consulte Comandos não suportados.

  • MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB

  • MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Sintaxe

O comando tem a seguinte sintaxe:

db.runCommand(
   {
     connectionStatus: 1,
     showPrivileges: <boolean>
   }
)

Campos de comando

connectionStatus suporta o seguinte campo opcional:

Campo
Tipo
Descrição

showPrivileges

booleano

Opcional. Defina showPrivileges como true para instruir a retornar o connectionStatus conjunto completo de privilégios que os usuários autenticados atualmente possuem.

Por padrão, este campo é false.

Exemplo

Para executar connectionStatus, use o método db.runCommand(), conforme descrito a seguir:

db.runCommand( { connectionStatus: 1, showPrivileges: true } )

Saída

connectionStatus.authInfo

Um documento com dados sobre o estado de autenticação da conexão atual, incluindo usuários e permissões disponíveis.

connectionStatus.authinfo.authenticatedUsers

Uma matriz com documentos para cada usuário autenticado

connectionStatus.authInfo.authenticatedUsers[n].user

O nome do usuário.

connectionStatus.authInfo.authenticatedUsers[n].db

O banco de dados associado às credenciais do usuário.

connectionStatus.authinfo.authenticatedUserRoles

Uma matriz com documentos para cada função concedida à conexão atual:

connectionStatus.authinfo.authenticatedUserRoles[n].role

A definição das funções atuais associadas aos usuários autenticados atuais. Consulte Funções Internas e Ações de Privilégio para obter mais informações.

connectionStatus.authinfo.authenticatedUserRoles[n].db

O banco de dados ao qual o role se aplica.

connectionStatus.authInfo.authenticatedUserPrivileges

Uma array com documentos descrevendo as ações concedidas à conexão atual, agrupada por recurso.

connectionStatus.authInfo.authenticatedUserPrivileges[n].resource

Um documento que descreve o banco de dados e, se aplicável, a coleção à qual connectionStatus.authInfo.authenticatedUserPrivileges[n].actions se aplica.

connectionStatus.authInfo.authenticatedUserPrivileges[n].actions

Uma array listando as ações de privilégio às quais a conexão tem acesso para o recurso especificado.

connectionStatus.ok

O valor de retorno do comando. Um valor de 1 indica o sucesso.

Voltar

connPoolStats

Próximo

tamanho de dados

Nesta página