MongoDB com drivers
Definição
db.collection.estimatedDocumentCount(options)Retorna a contagem de todos os documentos em uma coleção ou exibição.
db.collection.estimatedDocumentCount( <options> )
Parâmetros
Parâmetro | Tipo | Descrição |
|---|---|---|
opções | documento | Opcional. Opções adicionais que afetam o comportamento da contagem. |
Campos
O documento options pode conter o seguinte:
Campo | Tipo | Descrição |
|---|---|---|
| inteiro | Opcional. A quantidade máxima de tempo para permitir a execução da contagem. |
Compatibilidade
Esse método está disponível em implantações hospedadas nos seguintes ambientes:
- MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud
Observação
This command is supported in all MongoDB Atlas clusters. For information on Atlas support for all commands, see Unsupported Commands.
MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB
Comportamento
Mecânica
db.collection.estimatedDocumentCount() não usa um query filter e, em vez disso, usa metadados para retornar a contagem de uma coleção.
Para uma visualização:
Não há metadados.
A contagem de documentos é calculada executando o pipeline de agregação na definição da visualização.
Não há contagem rápida de documentos estimada.
Clusters fragmentados
Em um cluster fragmentado, a contagem resultante não filtrará corretamente documentos órfãos.
Desligamento impuro
Esta seção se aplica apenas a coleções.
Após um desligamento incorreto, a contagem pode estar incorreta.
After an unclean shutdown of a mongod using the Wired Tiger storage engine, count statistics reported by db.collection.estimatedDocumentCount() may be inaccurate.
A quantidade de desvio depende do número de operações de inserção, atualização ou exclusão executadas entre o último ponto de verificação e o desligamento não limpo. Os pontos de verificação geralmente ocorrem a cada 60 segundos. No entanto, mongod instâncias executadas com configurações de --syncdelay não padrão podem ter pontos de verificação mais ou menos frequentes.
Execute validate em cada collection no mongod para restaurar as estatísticas depois de um desligamento impróprio.
Após um desligamento impróprio:
validateatualiza a estatística de contagem nacollStatssaída com o valor mais recente.
Desconexão do cliente
If the client that issued db.collection.estimatedDocumentCount() disconnects before the operation completes, MongoDB marks db.collection.estimatedDocumentCount() for termination using killOp.
Contagem e Transações
When you use db.collection.estimatedDocumentCount() in a transaction, the resulting count will not filter out any uncommitted multi-document transactions.
Exemplo
Os exemplos nesta página usam dados do conjunto de dados sample_mflix. Para obter detalhes sobre como carregar este conjunto de dados em sua implantação do MongoDB autogerenciado, consulte Carregar o conjunto de dados de amostra. Se você fez alguma modificação nos bancos de dados de amostra, talvez seja necessário descartar e recriar os bancos de dados para executar os exemplos nesta página.
The following example uses db.collection.estimatedDocumentCount() to retrieve the count of all documents in the movies collection:
db.movies.estimatedDocumentCount({})
21349
Dica
Estágio do pipeline CollStats com a opção de contagem