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: o serviço totalmente gerenciado para implantações do MongoDB na nuvem
Observação
Este comando é aceito em todos os clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas a todos os comandos, consulte Comandos não suportados.
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.
Depois de um desligamento impróprio de um usando mongod o mecanismo de armazenamento Wired Tiger, as estatísticas de contagem relatadas por podem ser db.collection.estimatedDocumentCount() imprecisas.
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
Se o cliente que emitiu db.collection.estimatedDocumentCount() se desconectar antes da conclusão da operação, o MongoDB marcará para db.collection.estimatedDocumentCount() encerramento killOp usando.
Contagem e Transações
Quando você usa em uma transação, a contagem resultante não filtra nenhuma transação db.collection.estimatedDocumentCount()de vários documentosnão confirmada.
Exemplo
O exemplo a seguir usa para recuperar a contagem de todos os documentos db.collection.estimatedDocumentCount() na orders coleção:
db.orders.estimatedDocumentCount({})