MongoDB
 sql >> Base de Dados >  >> NoSQL >> MongoDB

MongoDB countDocumentos()


No MongoDB o db.collection.countDocuments() O método retorna a contagem de documentos que correspondem à consulta de uma coleção ou exibição.

A collection parte é o nome da coleção ou visualização para executar a operação de contagem.

Exemplo


Suponha que tenhamos uma coleção chamada pets com os seguintes documentos:
{ "_id" : 1, "name" : "Wag", "type" : "Dog", "weight" : 20 }
{ "_id" : 2, "name" : "Bark", "type" : "Dog", "weight" : 10 }
{ "_id" : 3, "name" : "Meow", "type" : "Cat", "weight" : 7 }
{ "_id" : 4, "name" : "Scratch", "type" : "Cat", "weight" : 8 }
{ "_id" : 5, "name" : "Bruce", "type" : "Bat", "weight" : 3 }
{ "_id" : 6, "name" : "Fetch", "type" : "Dog", "weight" : 17 }
{ "_id" : 7, "name" : "Jake", "type" : "Dog", "weight" : 30 }

Podemos usar a seguinte consulta para retornar o número de documentos na coleção:
db.pets.countDocuments({})

Resultado:
7

Contar o resultado de uma consulta


Você pode contar o resultado de uma consulta passando os critérios de consulta.

Exemplo:
db.pets.countDocuments({
    "type": "Dog"
})

Resultado:
4

Neste exemplo, descobrimos que há quatro cães na coleção.

Vamos verificar a contagem de outra consulta. Desta vez vamos descobrir quantos animais de estimação têm um peso superior a uma certa quantidade. 
db.pets.countDocuments({
    "weight": { $gt: 10 }
})

Resultado:
3

Limitar a contagem


Você usa o limit parâmetro para especificar um número máximo de documentos a serem contados.

Exemplo:
db.pets.countDocuments( {}, { limit: 5 } )

Resultado:
5

Vimos antes que na verdade existem 7 documentos nesta coleção, mas neste exemplo limitamos a contar no máximo 5.

Se o limite for maior que a contagem real, o resultado não será afetado pelo limit argumento.

Exemplo:
db.pets.countDocuments( {}, { limit: 10 } )

Resultado:
7

Ignorando documentos


Você pode contar usando o skip parâmetro para pular vários documentos antes de contar.

Exemplo:
db.pets.countDocuments( {}, { skip: 5 } )

Resultado:
2

Descontinuação de count() em favor de countDocuments()


Observe que a documentação do MongoDB afirma o seguinte:

Drivers MongoDB compatíveis com os recursos 4.0 descontinuam seus respectivos cursores e coleções count() APIs a favor de novas APIs para countDocuments() e estimatedDocumentCount() . Para os nomes de API específicos para um determinado driver, consulte a documentação do driver.

Mais informações


O countDocuments() método não depende de metadados para retornar a contagem como o count() método faz. Em vez disso, ele realiza uma agregação dos documentos, o que resulta em uma contagem precisa (o que nem sempre pode ser dito para o count() método).

De acordo com a documentação do MongoDB, countDocuments() é preciso mesmo após um desligamento incorreto ou na presença de documentos órfãos em um cluster fragmentado.

O db.collection.count() também aceita uma hint parâmetro e um maxTimeMS parâmetro.

Consulte a documentação do MongoDB para obter mais informações.