Menu Docs

Página inicial do Docs

/

Manual do MongoDB

/

/

Comandos de banco de dados

/

status da conexão

Nesta página

Definição

Compatibilidade
Sintaxe
Exemplo
Saída

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 verdadeiro para instruir `connectionStatus` a retornar o conjunto completo de privilégios que os usuários atualmente autenticados 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 integradas em implantações autogerenciadas e Ações de privilégio para implantações autogerenciadas para 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

Definição
Compatibilidade
Sintaxe
Exemplo
Saída