Menu Docs

Página inicial do DocsDesenvolver aplicaçõesManual do MongoDB

db.collection.estimatedDocumentCount()

Nesta página

  • Definição
  • Comportamento
  • Exemplo
db.collection.estimatedDocumentCount(options)

Importante

Método mongosh

Esta página documenta um método mongosh . Esta não é a documentação para comandos de banco de dados ou drivers específicos de idioma, como Node.js.

Para o comando de banco de dados, consulte o campo count retornado pelo comando collStats.

Para drivers de API do MongoDB, consulte a documentação do driver MongoDB específica do idioma.

Para a documentação de shell legada do mongo, consulte a documentação para a versão correspondente do MongoDB Server:

mongo shell v4.4

Retorna a contagem de todos os documentos em uma coleção ou exibição.

db.collection.estimatedDocumentCount( <options> )
Parâmetro
Tipo
Descrição
opções
documento
Opcional. Opções adicionais que afetam o comportamento da contagem.

O documento options pode conter o seguinte:

Campo
Tipo
Descrição
maxTimeMS
inteiro
Opcional. A quantidade máxima de tempo para permitir a execução da contagem.

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.

Em um cluster fragmentado, a contagem resultante não filtrará corretamente documentos órfãos.

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 mongod usando o mecanismo de armazenamento Wired Tiger , as estatísticas de contagem relatadas por db.collection.estimatedDocumentCount() podem ser 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:

A partir do MongoDB 4.2, se o cliente que emitiu db.collection.estimatedDocumentCount() se desconectar antes da conclusão da operação, o MongoDB marcará db.collection.estimatedDocumentCount() para encerramento usando killOp.

Quando você usa db.collection.estimatedDocumentCount() em uma transação, a contagem resultante não filtra nenhuma transação de vários documentosnão confirmada.

O exemplo a seguir usa db.collection.estimatedDocumentCount() para recuperar a contagem de todos os documentos na coleção orders :

db.orders.estimatedDocumentCount({})

Dica

← db.collection.ensureIndex()