Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

db.runCommand()

Nesta página

  • Definição
  • Comportamento
  • Resposta
db.runCommand(command)

Fornece um auxiliar para executarcomandos de banco de dados especificados. Esse é o método preferido para emitir comandos do 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 do banco de dados , especificado no formulário 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.

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

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. O MongoDB usa o tempo lógico para solicitar operações. 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.

$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.

← db.rotateCertificates()