db.collection.count()

Contagens Imprecisas Sem Predicado de Consulta

Ao chamar count() sem um predicado de query, você pode receber contagens imprecisas de documentos. Sem um predicado de query, os métodos count() retornam resultados com base nos metadados da coleção, o que pode resultar em uma contagem aproximada. Em particular,

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

• Após um desligamento não limpo ou sincronização inicial, a contagem pode estar incorreta.

Para contagens com base nos metadados da coleção, consulte também o estágio do pipeline do CollStats com a opção de contagem.

Contagem e Transações

Você não pode usar count e assistentes de shell count() e db.collection.count() em transações.

Para obter detalhes, consulte Operações de transações e contagem.

Clusters fragmentados

Em um cluster fragmentado, db.collection.count() sem um predicado de query pode resultar em uma contagem imprecisa se documentos órfãos existirem ou se uma migração de parte estiver em andamento.

Para evitar estas situações, em um cluster fragmentado, utilize o método db.collection.aggregate():

Você pode usar o estágio $count para contar os documentos. Por exemplo, a seguinte operação conta os documentos em uma coleção:

db.collection.aggregate( [
   { $count: "myCount" }
])

O estágio $count é equivalente à seguinte sequência $group + $project:

db.collection.aggregate( [
   { $group: { _id: null, count: { $sum: 1 } } },
   { $project: { _id: 0 } }
] )

Uso do índice

Considere uma coleção com o seguinte índice:

{ a: 1, b: 1 }

Ao realizar uma contagem, o MongoDB pode retornar a contagem usando somente o índice se:

• a consulta puder usar um índice,

• a consulta contém apenas condições nas chaves do índicee

• os predicados da consulta acessarem uma única faixa contígua de chaves de índice.

Por exemplo, as operações a seguir podem retornar a contagem usando apenas o índice:

db.collection.find( { a: 5, b: 5 } ).count()
db.collection.find( { a: { $gt: 5 } } ).count()
db.collection.find( { a: 5, b: { $gt: 10 } } ).count()

No entanto, se a consulta puder usar um índice, mas os predicados da consulta não acessarem uma única faixa contígua de chaves de índice ou a consulta também contiver condições em campos fora do índice, além de usar o índice, o MongoDB também deverá ler os documentos para retornar a contagem.

db.collection.find( { a: 5, b: { $in: [ 1, 2, 3 ] } } ).count()
db.collection.find( { a: { $gt: 5 }, b: 5 } ).count()
db.collection.find( { a: 5, b: 5, c: 5 } ).count()

Nesses casos, durante a leitura inicial dos documentos, o MongoDB pagina os documentos na memória de modo que as chamadas subsequentes da mesma operação de contagem terão melhor desempenho.

Precisão após Desligamento Inesperado

Após um desligamento impuro de um mongod usando o mecanismo de armazenamento Wired Tiger, as estatísticas de contagem relatadas por count() 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:

• validate atualiza a estatística de contagem na collStats saída com o valor mais recente.

• Outras estatísticas, como o número de documentos inseridos ou removidos na collStats saída , são estimativas.

Desconexão do cliente

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

Contar todos os Documentos em uma Coleção

Para contar o número de todos os documentos na coleção orders, utilize a seguinte operação:

db.orders.count()

Esta operação é equivalente ao seguinte:

db.orders.find().count()

Contagem de todos os Documentos que Correspondem a uma Query

Conte o número de documentos na coleção orders com o campo ord_dt maior que new Date('01/01/2012'):

db.orders.count( { ord_dt: { $gt: new Date('01/01/2012') } } )

A consulta é equivalente ao seguinte:

db.orders.find( { ord_dt: { $gt: new Date('01/01/2012') } } ).count()