/ /

Fundamentals

Lea

Docs Home

Librerías de clientes

Driver C#/.NET

Fundamentals

Lea

Contabilizar documentos

Overview

En esta guía, puedes aprender cómo obtener un recuento exacto y estimado del número de documentos en tu colección.

Datos de muestra

Los ejemplos de esta guía usan los siguientes documentos en una colección llamada students:

{ "_id": 1, "name": "Jonathon Howard ", "finalGrade": 87.5 }
{ "_id": 2, "name": "Keisha Freeman", "finalGrade": 12.3 }
{ "_id": 3, "name": "Wei Zhang", "finalGrade": 99.0 }
{ "_id": 4, "name": "Juan Gonzalez", "finalGrade": 85.5 }
{ "_id": 5, "name": "Erik Trout", "finalGrade": 72.3 }
{ "_id": 6, "name": "Demarcus Smith", "finalGrade": 88.8 }

La siguiente clase Student modela los documentos en esta colección:

public class Student {
    public int Id { get; set; }
    public string Name { get; set; }
    public double FinalGrade { get; set; }
}

Nota

Los documentos de la colección students utilizan la convención de nomenclatura camel case. En los ejemplos de esta guía, se utiliza un ConventionPack para deserializar los campos de la colección en notación Pascal y asignarlos a las propiedades de la clase Student.

Para aprender más sobre la serialización personalizada, consultar Serialización personalizada.

Conteo preciso

Para contar el número de documentos que coinciden con tu filtro de query, utiliza el método CountDocuments(). Si pasas un filtro de query vacío, este método devuelve el número total de documentos en la colección.

Ejemplo

El siguiente ejemplo cuenta el número de documentos donde el valor de finalGrade es menor que 80:

var filter = Builders<Student>.Filter.Lt(s => s.FinalGrade, 80.0);
var count = _myColl.CountDocuments(filter);
Console.WriteLine("Number of documents with a final grade less than 80: " + count);

Number of documents with a final grade less than 80: 2

Modificar comportamiento

Puedes modificar el comportamiento de CountDocuments() pasando un tipo CountOptions como parámetro. Si no especifica ninguna opción, el driver utiliza valores por defecto.

Puedes establecer las siguientes propiedades en un objeto CountOptions:

Propiedad	Descripción
`Collation`	El tipo de intercalación de lenguaje que se debe usar al clasificar los resultados. Por defecto: `null`
`Hint`	El índice que se usará para buscar documentos que contar. Por defecto: `null`
`Limit`	El número máximo de documentos que se deben contar. Por defecto: `0`
`MaxTime`	El tiempo máximo que la query puede ejecutarse en el servidor. Por defecto: `null`
`Skip`	El número de documentos que se deben omitir antes de contar. Por defecto: `0`

Tip

Cuando se utiliza CountDocuments() para devolver el número total de documentos en una colección, MongoDB realiza un escaneo de colección. Puedes evitar un escaneo de colección y mejorar el rendimiento de este método utilizando una sugerencia para aprovechar la funcionalidad incorporada en el índice en el campo _id. Usa esta técnica solo cuando llames a CountDocuments() con un parámetro de query vacío.

var filter = Builders<Student>.Filter.Empty;
CountOptions opts = new CountOptions(){Hint = "_id_"};
var count = collection.CountDocuments(filter, opts);

Recuento estimado

Para estimar el número total de documentos en tu colección, utiliza el método EstimatedDocumentCount().

Nota

El método EstimatedDocumentCount() es más eficiente que el método CountDocuments() porque utiliza los metadatos de la colección en lugar de escanear toda la colección.

Modificar comportamiento

Puedes modificar el comportamiento de EstimatedDocumentCount() pasando un tipo EstimatedDocumentCountOptions como parámetro. Si no especifica ninguna opción, el driver utiliza valores por defecto.

Puedes establecer las siguientes propiedades en un objeto EstimatedDocumentCountOptions:

Propiedad	Descripción
`MaxTime`	El tiempo máximo que la query puede ejecutarse en el servidor. Por defecto: `null`

Ejemplo

El siguiente ejemplo estima el número de documentos en la colección students:

var count = _myColl.EstimatedDocumentCount();
Console.WriteLine("Estimated number of documents in the students collection: " + count);

Estimated number of documents in the students collection: 6

Agregación

Puede utilizar el método de creación Count() para contar el número de documentos en una canalización de agregación.

Ejemplo

El siguiente ejemplo realiza las siguientes acciones:

Especifica una etapa de coincidencia para encontrar documentos con un valor de FinalGrade mayor que 80
Cuenta el número de documentos que cumplen con el criterio

var filter = Builders<Student>
  .Filter.Gt(s => s.FinalGrade, 80);
var result = _myColl.Aggregate().Match(filter).Count();
Console.WriteLine("Number of documents with a final grade more than 80: " + result.First().Count);

Number of documents with a final grade more than 80: 4

Información Adicional

Para aprender más sobre las operaciones mencionadas, consulte las siguientes guías:

Documentación de la API

Para obtener más información sobre cualquiera de los métodos o tipos discutidos en esta guía, consultar la siguiente documentación de la API:

Volver

Especifique los campos a devolver

Recuperar valores distintos de campo