cursor.count() (método mongosh)

Definición

cursor.count()

Importante

Método mongosh

Esta página documenta una mongosh Método. Esta no es la documentación de un controlador específico del lenguaje, como Node.js.

Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.

Nota

Los controladores de MongoDB descontinuan sus respectivas API de cursor y colección count() en favor de las nuevas API correspondientes a countDocuments() y estimatedDocumentCount(). Para conocer los nombres de API específicos de un controlador, consulte la documentación de la API del controlador.

Cuenta el número de documentos referenciados por un cursor. Añade el método a count() un find() Consulta para devolver el número de documentos coincidentes. La operación no ejecuta la consulta, sino que cuenta los resultados que devolvería.

El método tiene la siguiente forma de count() prototipo:

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

El método count() tiene el siguiente parámetro:

Parameter	Tipo	Descripción
`applySkipLimit`	booleano	Opcional. ignora cualquier valor que establezca para esta opción. El valor`mongosh` predeterminado `true` es. La opción especifica si se deben considerar los efectos de los métodos`cursor.skip()`y`cursor.limit()`en el recuento. De forma predeterminada, el método`count()`ignora los efectos de`cursor.skip()`y`cursor.limit()`. Debe establecer `applySkipLimit` en `true` para considerar el efecto de estos métodos. El shell heredado, que ahora está obsoleto, usaba su configuración para esta `mongo` opción.

MongoDB también proporciona un equivalente como alternativa a db.collection.count() la db.collection.find(<query>).count() construcción.

MongoDB admite el uso de hint() con.Consulte "Especificar count() el índice a utilizar" para ver un ejemplo.

Tip

cursor.size()

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Nota

Este comando es compatible con todos los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulte Comandos no compatibles.

MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Comportamiento

Conteos inexactos sin predicado de query

Al llamar a count() en una operación que no especifica find() un predicado de consulta, el método puede count() count() devolver recuentos de documentos inexactos. Estos métodos devuelven resultados basados en los metadatos de la colección, lo que puede resultar en un recuento aproximado. En particular,

En un clúster, el recuento resultante no filtrará correctamente los documentos huérfanos.
Después de un apagado no limpio o una sincronización inicial basada en copia de archivo, el recuento puede ser incorrecto.

Para los recuentos basados en los metadatos de la colección, consulta también la etapa de la pipeline de collStats con la opción count.

Conteo y transacciones

No se pueden utilizar count y count() los ayudantes db.collection.count() de shell y en las transacciones.

Para obtener más detalles, se debe consultar Transacciones y operaciones de recuento.

Clústeres fragmentados

En un clúster fragmentado, sin un predicadocount() de find consulta en puede generar un recuento inexacto si existen documentos huérfanos o si hay una migración de fragmentos en progreso.

Para evitar estas situaciones, en un clúster fragmentado, usa el método db.collection.aggregate():

Puedes utilizar la etapa $count para contar los documentos. Por ejemplo, la siguiente operación cuenta los documentos en una colección:

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

La etapa $count es equivalente a la siguiente secuencia de $group + $project:

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

Tip

$collStats para devolver un conteo aproximado basado en los metadatos de la colección.

Uso del índice

Considera una colección con el siguiente índice:

{ a: 1, b: 1 }

Al realizar un recuento, MongoDB puede devolver el recuento utilizando solo el índice si:

La query puede usar un índice,
la query solo contiene condiciones sobre las claves del índice, y
los predicados de query acceden a un único rango contiguo de claves de índice.

Por ejemplo, las siguientes operaciones pueden devolver el conteo usando solo el í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()

Sin embargo, si la query puede utilizar un índice pero los predicados de la query no acceden a un solo rango contiguo de claves de índice o la query también contiene condiciones en campos fuera del índice, entonces, además de utilizar el índice, MongoDB también debe leer los documentos para devolver el recuento.

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()

En tales casos, durante la lectura inicial de los documentos, MongoDB carga los documentos en memoria de manera que las llamadas posteriores a la misma operación de conteo tengan un mejor rendimiento.

Ejemplos

Los siguientes son ejemplos del método count().

Contar todos los documentos

La siguiente operación cuenta el número de todos los documentos en la colección orders:

db.orders.find().count()

Contar documentos que coinciden con una consulta

La siguiente operación cuenta el número de documentos en la colección orders con el campo ord_dt mayor que new Date('01/01/2012'):

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

Limitar documentos en el recuento

La siguiente operación cuenta el número de documentos en la orders colección con el campo ord_dt mayor que new Date('01/01/2012') teniendo en cuenta el efecto limit(5) de:

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

Especifique el índice a utilizar

La siguiente operación utiliza el índice denominado "status_1", que tiene la especificación de clave de índice de { status: 1 }, para devolver un recuento de los documentos en la colección orders con el campo ord_dt mayor que new Date('01/01/2012') y el campo status es igual a "D":

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

Volver

cursor.comment

cursor.disableBlockWarnings