Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Referência
/
Métodos de mongosh
/
Bancos de dados

db.runCommand()

Nesta página

  • Definição
  • Compatibilidade
  • Comportamento
  • Resposta

Definição

db.runCommand(command)

Fornece um auxiliar para executar comandos de banco de dados especificados. Esse é o método preferencial para emitir comandos de banco de dados, pois fornece uma interface consistente entre o shell e os drivers.

Parâmetro
Tipo
Descrição

command

documento ou string

" Um comando de banco de dados de dados , especificado no formulário de documento ou como uma string. Se especificado como uma string, db.runCommand() transforma a string em um documento."

Para especificar um limite de tempo em milissegundos, consulte Terminar operações em execução.

Compatibilidade

Esse método 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

Comportamento

db.runCommand() executa o comando no contexto do banco de banco de dados atual. Alguns comandos são aplicáveis somente no contexto do banco de banco de dados admin , e você deve alterar seu objeto db antes de executar esses comandos ou usar db.adminCommand().

Resposta

O método retorna um documento de resposta que contém os seguintes campos:

Campo
Descrição

<command result>

Campos de resultados específicos do command que executou.

ok

Um número que indica se o comando obteve êxito (1) ou falhou (0).

operationTime

A hora lógica da operação executada, representada no MongoDB pelo carimbo de data/hora da entrada do oplog. Somente para conjuntos de réplicas e clusters fragmentados

Se o comando não gerar uma entrada no oplog, por exemplo, uma operação de leitura, a operação não avançará o relógio lógico. Neste caso, operationTime retorna:

Para operações associadas a sessões causalmente consistentes, os drivers do MongoDB usam o tempo lógico para definir automaticamente as operações de leitura e o período afterClusterTime.

Novidade na versão 3.6.

$clusterTime

Um documento que retorna a hora do cluster assinado. O tempo de cluster é um tempo lógico usado para ordenar operações. Somente para conjuntos de réplicas e clusters fragmentados. Apenas para uso interno.

O documento contém os seguintes campos:

  • clusterTime: timestamp da hora mais alta conhecida do cluster para o membro.

  • signature: um documento que contém o hash da hora do cluster e o ID da chave usada para assinar a hora do cluster.

Novidade na versão 3.6.

Voltar

db.rotateCertificates

Próximo

db.serverBuildInfo