stats() (Estatísticas da Coleção)
Última atualização: 2026-10-09
stats() (Estatísticas da Coleção)
stats() retorna estatísticas da coleção, ex.: `db.users.stats()` — contagem de documentos, tamanho da coleção, tamanho de armazenamento, contagem e tamanho de índices, além de informações de fragmentação. É a ferramenta padrão para avaliação de capacidade e saúde. Os campos de tamanho estão em bytes, e algumas métricas como contagem de documentos são estimativas baseadas em metadados.
| Categoria | Índice e Administração |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
db.<collection>.stats()Retorno：Objeto de estatísticas com count, size, storageSize, indexSizes, etc.
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// stats: inspeciona o tamanho e a contagem de users
const s = db.users.stats()
print('Docs: ' + s.count + ', storage: ' + s.storageSize + ' bytes')Saída：
Docs: 1000, armazenamento: 65536 bytes📌 Notas
- Campos como count são baseados em metadados e podem divergir
- Os campos de tamanho estão em bytes
- Os tamanhos de índice ficam em indexSizes, chaveados pelo nome do índice
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QEm que unidade estão os campos de tamanho de stats()?
ABytes. Divida storageSize por 1024*1024 para obter MB.
QA contagem em stats() é precisa?
AGeralmente próxima, porém baseada em metadados e pode defasar sob escritas intensas; use countDocuments() para exatidão.
QComo vejo o tamanho de cada índice?
ALeia o objeto indexSizes — as chaves são nomes de índices e os valores, tamanhos em bytes.
