runCommand() (Executar Comando)
Última atualização: 2026-10-09
runCommand() (Executar Comando)
db.runCommand() executa qualquer comando de banco no mongosh — o ponto de entrada genérico para comandos de baixo nível sem helpers dedicados (serverStatus, collStats, currentOp). A maioria dos comandos tem métodos helper (ex.: db.collection.stats()), mas runCommand dá controle total.
| Categoria | Comandos de Administração |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
db.runCommand({ <command>: <args>, ... })⚙️ Parâmetros
| nome do comando | Primeiro campo do documento de comando; seu valor é o objeto de argumento. |
|---|
Retorno：O documento de resultado do comando com ok (1 sucesso, 0 falha) mais campos específicos do comando
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// runCommand: estatísticas do banco
db.runCommand({ dbStats: 1 })
// estatísticas da coleção
db.runCommand({ collStats: "orders" })Saída：
{
db: "shop",
collections: 5,
objects: 1200,
dataSize: 48213,
ok: 1
}📌 Notas
- O primeiro campo é o nome do comando; seu valor é o argumento
- ok: 1 significa sucesso; ok: 0 falha (errmsg tem o motivo)
- A maioria dos comandos tem helpers — prefira-os para legibilidade
- Privilégios insuficientes geram erros unauthorized
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QComo runCommand e métodos helper se relacionam?
AHelpers como db.stats() internamente chamam runCommand, embrulhando argumentos e análise do resultado. runCommand é a entrada genérica subjacente.
QComo vejo a saída de ajuda de um comando?
AAdicione $help: 1 aos argumentos, ex.: db.runCommand({ serverStatus: 1, $help: 1 }).
QPor que alguns comandos exigem adminCommand?
AComandos com escopo de admin (renameCollection, setParameter, ...) vivem no db admin e exigem db.adminCommand.
