/ /

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. Consulte la sección intercalación de esta página para obtener más información. Por defecto: `null`
`Hint`	Índice que se utilizará para buscar documentos que se vayan a contabilizar. Valor predeterminado: `null`
`Limit`	Número máximo de documentos a contabilizar. Valor predeterminado: `0`
`MaxTime`	El tiempo máximo que la query puede ejecutarse en el servidor. Por defecto: `null`
`Skip`	Número de documentos que se deben omitir antes de contar. Valor predeterminado: `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);

Intercalación

Para configurar la intercalación para tu operación, crea una instancia de la clase intercalación.

La siguiente tabla describe los parámetros que acepta el constructor Collation. También enumera la propiedad de clase correspondiente que se puede usar para leer el valor de cada configuración.

Parameter	Descripción	Propiedad de clase
`locale`	Especifica la configuración regional de Componentes Internacionales para Unicode (ICU). Para obtener una lista de las configuraciones regionales compatibles, consulte Configuraciones regionales de intercalación y parámetros predeterminados en el Manual del servidor MongoDB. Si desea utilizar una comparación binaria simple, utilice la `Collation.Simple` propiedad estática para devolver un `Collation` objeto con establecido `locale` `"simple"`en. Tipo de datos: `string`	`Locale`
`caseLevel`	(Opcional) Especifica si se debe incluir la comparación de mayúsculas y minúsculas. Cuando este argumento `true` es, el comportamiento del controlador depende del valor del `strength` argumento: - Si `strength` `CollationStrength.Primary`es, el controlador compara caracteres base y mayúsculas y minúsculas. - Si `strength` `CollationStrength.Secondary`es, el controlador compara caracteres base, diacríticos, otras diferencias secundarias y mayúsculas y minúsculas. - Si `strength` es cualquier otro valor, este argumento se ignora. Cuando este argumento `false` es, el controlador no incluye la comparación de mayúsculas y minúsculas en el nivel `Primary` de fuerza `Secondary` o. Tipo `boolean` de datos: Predeterminado: `false`	`CaseLevel`
`caseFirst`	(Opcional) Especifica el orden de clasificación de las diferencias de mayúsculas y minúsculas durante las comparaciones de nivel terciario. Tipo de datos: CollationCaseFirst Valor predeterminado: `CollationCaseFirst.Off`	`CaseFirst`
`strength`	(Opcional) Especifica el nivel de comparación a realizar, tal como se define en la documentación de la UCI. Tipo de datos: CollationStrength Valor predeterminado: `CollationStrength.Tertiary`	`Strength`
`numericOrdering`	(Opcional) Especifica si el controlador compara las cadenas numéricas como números. Si este argumento `true` es, el controlador compara las cadenas numéricas como números. Por ejemplo, al comparar las cadenas "10" y "2", el controlador trata los valores como 10 2y, y encuentra 10 que es mayor. Si este argumento es `false` o se excluye, el controlador compara las cadenas numéricas como cadenas. Por ejemplo, al comparar las cadenas "10" y "2", el controlador compara un carácter a la vez. Como "1" es menor que "2", el controlador encuentra10que " " es menor que "2". Para obtener más información, consulte Restricciones de intercalación en el manual del servidor MongoDB. Tipo de datos: `boolean` Predeterminado: `false`	`NumericOrdering`
`alternate`	(Opcional) Especifica si el controlador considera los espacios en blanco y la puntuación como caracteres base para fines de comparación. Tipo de datos: CollationAlternate Valor predeterminado: `CollationAlternate.NonIgnorable` (los espacios y la puntuación se consideran caracteres base)	`Alternate`
`maxVariable`	(Opcional) Especifica qué caracteres considera el controlador como ignorables cuando el `alternate` argumento `CollationAlternate.Shifted` es. Tipo de datos: CollationMaxVariable Valor predeterminado: `CollationMaxVariable.Punctuation` (el controlador ignora la puntuación y los espacios)	`MaxVariable`
`normalization`	(Opcional) Especifica si el controlador normaliza el texto según sea necesario. La mayoría del texto no requiere normalización. Para obtener más información sobre la normalización, consulte la documentación de ICU. Tipo de datos: `boolean` Predeterminado: `false`	`Normalization`
`backwards`	(Opcional) Especifica si las cadenas que contienen diacríticos se ordenan desde el final de la cadena hacia el principio. Tipo de datos: `boolean` Valor predeterminado: `false`	`Backwards`

Más información sobre la intercalación en la página Intercalación en el manual de MongoDB Server.

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

Valores únicos de campo