dbStats (Estatísticas do Banco)
Última atualização: 2026-10-09
dbStats (Estatísticas do Banco)
dbStats retorna estatísticas do banco atual — contagem de coleções, contagem de documentos, tamanho de dados, tamanho de índices, uso de armazenamento — para planejamento de capacidade e monitoramento. No mongosh use db.stats() ou db.runCommand({ dbStats: 1 }). O argumento scale define unidades de bytes (1024 para KB). Em clusters fragmentados, retorna números agregados.
| Categoria | Monitoramento e Diagnóstico |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
db.stats()
db.runCommand({ dbStats: 1, scale: 1024 })⚙️ Parâmetros
| scale | Fator de unidade de byte; 1024 significa kilobytes. |
|---|
Retorno：Um documento de estatísticas: db, collections, objects, dataSize, storageSize, indexSize, ok e mais
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// dbStats: estatísticas do banco
use shop
db.runCommand({ dbStats: 1, scale: 1024 })Saída：
{
db: 'shop',
collections: 5,
objects: 1200,
avgObjSize: 402,
dataSize: 482,
storageSize: 1024,
indexes: 7,
indexSize: 341,
ok: 1
}📌 Notas
- scale define a unidade (1024 para KB)
- dataSize é lógico; storageSize é o uso real de disco
- Clusters fragmentados retornam números agregados
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QdbStats vs collStats?
AdbStats agrega no nível do banco; collStats visa uma única coleção.
QComo dataSize e storageSize diferem?
AdataSize é o tamanho lógico dos documentos; storageSize é o uso de disco incluindo espaço livre e compressão.
QComo mudo as unidades?
APasse scale: 1024 para KB; omita-o para bytes.
