Definición
$countPasa un documento a la siguiente etapa que contiene un recuento de la cantidad de documentos introducidos en la etapa.
Nota
Desambiguación
Esta página describe la etapa
$countdel pipeline de agregación. Para el acumulador de agregación$count, consulte$count (aggregation accumulator).
Compatibilidad
Puedes usar $count para implementaciones alojadas en los siguientes entornos:
MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube
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.
Sintaxis
$count tiene la siguiente sintaxis:
{ $count: <string> }
<string> es el nombre del campo de salida que tiene la cuenta como su valor. <string> debe ser una string no vacía, no debe comenzar con $ y no debe contener el carácter ..
Comportamiento
El tipo de retorno está representado por el tipo más pequeño que puede almacenar el valor final de la cuenta: integer → long → double
La etapa $count es equivalente a la siguiente secuencia de $group y $project:
db.collection.aggregate( [ { $group: { _id: null, myCount: { $sum: 1 } } }, { $project: { _id: 0 } } ] )
myCount es el campo de salida que almacena el conteo. Puede especificar otro nombre para el campo de salida.
Si el conjunto de datos de entrada está vacío, $count no devuelve un resultado.
Tip
db.collection.countDocuments() envuelve la $group etapa de agregación con una expresión $sum.
Ejemplos
Los ejemplos de esta página utilizan datos del conjunto de datos de muestra sample_mflix. Para obtener más información sobre cómo cargar este conjunto de datos en la implementación autogestionada de MongoDB, consultar Cargar el conjunto de datos de muestra. Si se realizó alguna modificación en las bases de datos de muestra, es posible que se deban descartar y volver a crear las bases de datos para ejecutar los ejemplos de esta página.
La siguiente operación de agregación consta de dos etapas:
La etapa
$matchfiltra los documentos dondemetacritices igual a100, para pasar solo esos documentos a la siguiente etapa.La etapa
$countdevuelve un conteo de los documentos restantes en la canalización de agregación y asigna el valor a un campo llamadoperfect_score_count.
db.movies.aggregate( [ { $match: { metacritic: { $eq: 100 } } }, { $count: "perfect_score_count" } ] )
[ { perfect_score_count: 8 } ]
Los ejemplos de C# en esta página utilizan la base de datos sample_mflix de los conjuntos de datos de muestra de Atlas. Para aprender a crear un clúster gratuito de MongoDB Atlas y cargar los conjuntos de datos de muestra, consulta Primeros pasos en la documentación del controlador de MongoDB .NET/C#.
La siguiente clase Movie modela los documentos en la colección sample_mflix.movies:
[] public class Movie { [] public ObjectId Id { get; set; } public string Title { get; set; } = null!; [] public int Metacritic { get; set; } }
Para usar el driver .NET / C# de MongoDB y agregar una etapa $count a una pipeline de agregación, llame a Count() método en un objeto PipelineDefinition.
El siguiente ejemplo crea una etapa de canalización que devuelve un recuento de todos los documentos en la colección movies donde el campo metacritic tiene el valor 100:
var pipeline = new EmptyPipelineDefinition<Movie>() .Match(Builders<Movie>.Filter.Eq(m => m.Metacritic, 100)) .Count();
Los ejemplos de Node.js en esta página utilizan la base de datos sample_mflix de los conjuntos de datos de muestra de Atlas. Para aprender a crear un clúster gratuito de MongoDB Atlas y cargar los conjuntos de datos de muestra, consulte Primeros pasos en la documentación del controlador de MongoDB Node.js.
Para utilizar el controlador de MongoDB Node.js para agregar una etapa de $count a una canalización de agregación, utilice el Operador $count en un objeto de canalización.
El siguiente ejemplo crea una etapa de pipeline que cuenta la cantidad de documentos de entrada de la colección sample_mflix.movies y devuelve un documento que contiene el conteo. A continuación, el ejemplo ejecuta la canalización de agregación:
const pipeline = [{ $count: "movies" }]; const cursor = collection.aggregate(pipeline); return cursor;