/ /

Métodos de mongosh

Cursors

Página inicial do Docs

Manual do MongoDB

Referência

Métodos de mongosh

Cursors

cursor.count()

Esta versão da documentação foi arquivada e não é mais suportada. Para atualizar seu sistema do 5.0, consulte osprocedimentos de atualização do MongoDB 6.0 .

Definição

cursor.count()

Importante

Método mongosh

Este é um método mongosh . Esta não é a documentação de Node.js ou de outros métodos de driver específicos da linguagem de programação.

Na maioria dos casos, os métodos mongosh funcionam da mesma forma que os métodos legado do shell mongo . No entanto, alguns métodos legado não estão disponíveis em mongosh.

Para a documentação do shell legado mongo, consulte a documentação para a release correspondente do MongoDB Server:

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

Observação

Os drivers do MongoDB compatíveis com os recursos do 4,0 depreciam seu respectivo cursor e coletam APIs do count() em favor de novas APIs que correspondem ao countDocuments() e estimatedDocumentCount(). Para obter os nomes de API específicos de um determinado driver, consulte a documentação da API do driver.

Conta o número de documentos referenciados por um cursor. Anexe o método count() a uma find() para retornar o número de documentos correspondentes. A operação não executa a query, mas conta os resultados que seriam retornados pela query.

Importante

Evite usar count() se a operação find() for executada sem um predicado de query, pois sem o predicado de query, esses 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 incorreto, 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.

O método count() tem a seguinte forma de protótipo:

db.collection.find(<query>).count()

O método count() tem o seguinte parâmetro:

Parâmetro	Tipo	Descrição
`applySkipLimit`	booleano	Opcional. Especifica se deve considerar os efeitos dos métodos e na `cursor.skip()` `cursor.limit()` contagem. Por padrão, o método`count()`ignora os efeitos do`cursor.skip()`e`cursor.limit()` . Defina `applySkipLimit` como `true` para considerar o efeito desses métodos.

O MongoDB também fornece um db.collection.count() equivalente como uma alternativa à construção db.collection.find(<query>).count().

O MongoDB oferece suporte ao uso de hint() com count(). Consulte Especificar o índice a ser usado para obter um exemplo.

Dica

cursor.size()

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

Contagem e Transações

Você não pode usar count, 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, count() sem um predicado de query no find 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 } }
] )

Dica

$collStats para retornar uma contagem aproximada com base nos metadados da coleção.

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.

Exemplos

Os exemplos a seguir são do método count() .

Contagem de todos os documentos

A seguinte operação conta o número de todos os documentos na collection orders:

db.orders.find().count()

Contagem de documentos que correspondem a uma query

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

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

Limitar documentos na contagem

A operação a seguir conta o número de documentos na coleção orders com o campo ord_dt maior que new Date('01/01/2012'), levando em conta o efeito do limit(5):

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

Especificar o índice a ser usado

A seguinte operação utiliza o índice denominado "status_1", que tem a especificação da chave de índice de { status: 1 }, para retornar uma contagem dos documentos na coleção orders com o campo ord_dt maior que new Date('01/01/2012') e o campo status é igual a "D":

db.orders.find(
   { ord_dt: { $gt: new Date('01/01/2012') }, status: "D" }
).hint( "status_1" ).count()

Voltar

cursor.comment

cursor.explain