No MongoDB o
cursor.count()
O método conta o número de documentos referenciados por um cursor. Observe que ele realmente não executa a consulta. Ele simplesmente conta e retorna o número de resultados que seriam retornados pela consulta.
O
cursor.count()
é um wrapper para o count
comando. 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.find().count()
Resultado:
7
Isso é o equivalente a fazer o seguinte:
db.pets.count()
Resultado:
7
A documentação do MongoDB realmente desaconselha o uso de
cursor.count()
quando o find()
é chamado sem um predicado de consulta. Isso porque, nesses casos, os resultados são baseados nos metadados da coleção, o que pode resultar em uma contagem aproximada. Contar o resultado de uma consulta
Você pode contar o resultado de uma consulta passando os critérios de consulta para o
find()
método. Exemplo:
db.pets.find({"type": "Dog"}).count()
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.find({"weight": { $gt: 10 }}).count()
Resultado:
3
Descontinuação
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çõescount()
APIs a favor de novas APIs paracountDocuments()
eestimatedDocumentCount()
. Para os nomes de API específicos para um determinado driver, consulte a documentação do driver.
O applySkipLimit
Parâmetro
O
cursor.count()
O método aceita um parâmetro opcional:o applySkipLimit
parâmetro. Este parâmetro especifica se os efeitos do
cursor.skip()
devem ser considerados e cursor.limit()
métodos na contagem. Por padrão, ele ignora quaisquer efeitos desses dois métodos. Para incluir os efeitos, use
appySkipLimit: true
. Mais informações
Consulte a documentação do MongoDB para obter mais informações.