estimatedDocumentCount() (Estimar Contagem de Documentos)
Última atualização: 2026-10-09
estimatedDocumentCount() (Estimar Contagem de Documentos)
estimatedDocumentCount() estima o total de documentos a partir dos metadados da coleção, ex.: `db.users.estimatedDocumentCount()`. Ele não recebe filtro e não varre nada, então é extremamente rápido, mas o valor pode defasar da realidade (especialmente em clusters fragmentados não atualizados). Serve para dashboards e estimativas de capacidade onde a precisão não é crítica; para contagens exatas use countDocuments().
| Categoria | Leitura |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
db.<collection>.estimatedDocumentCount()Retorno：Contagem total estimada de documentos (inteiro).
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// estimatedDocumentCount: verifica rapidamente o total de usuários
const n = db.users.estimatedDocumentCount()
print('Total users (estimate): ' + n)Saída：
Total de usuários (estimativa): 1000📌 Notas
- Não recebe filtro — somente a coleção inteira
- Baseado em metadados e pode defasar da realidade
- Rápido porém não garantidamente preciso; use countDocuments() quando a exatidão importa
🏷️ Tags Relacionados
💡 Casos Relacionados
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QPor que estimatedDocumentCount é mais rápido que countDocuments?
AEle lê a contagem dos metadados da coleção sem varrer documentos; countDocuments() realmente avalia o filtro.
QO estimatedDocumentCount é preciso?
AGeralmente próximo, mas não garantido; escritas intensas ou fragmentação podem ampliar a diferença.
QQual método de contagem devo escolher?
AUse countDocuments() para contagens exatas ou filtradas; estimatedDocumentCount() quando magnitude e velocidade importam.
