MongoDB – Método contarDocumentos()

En MongoDB, el método countDocuments() cuenta la cantidad de documentos que coinciden con los criterios de selección. Devuelve un valor numérico que representa el número total de documentos que coinciden con los criterios de selección. Se necesitan dos argumentos, uno es el criterio de selección y el otro es opcional. 

• Este método no utiliza metadatos para devolver el recuento. Realiza la agregación de los documentos y devuelve un recuento preciso.
• Puede utilizar este método en transacciones de varios documentos.
• Este método devuelve 0 para una colección vacía o si la colección dada no está presente en la base de datos.
• En este método, no puede usar los operadores $where, $near y $nearSphere como parte de las expresiones de consulta. 

Sintaxis:

db.Collection_name.countDocuments(

<Criterios_de_selección>,

{

    límite: <entero>,

    saltar: <entero>,

    sugerencia: <string o documento>,

    maxTimeMS: <entero>,  

})

Parámetros:

• El primer parámetro es un criterio de selección. El tipo de este parámetro es un documento. Si desea contar el número total de documentos presentes en la colección, pase un documento vacío ({}).
• El segundo parámetro es opcional.

Parámetros opcionales:

• límite: Es el número máximo de documentos a contabilizar.
• skip: Es el número de documentos a saltar antes de contar.
• sugerencia: es un documento o campo que especifica el índice que se utilizará para admitir el filtro. Puede tomar un documento de especificación de índice o la string de nombre de índice y si especifica un índice que no existe, dará un error.
• maxTimeMs: Es la cantidad máxima de tiempo para permitir que se ejecute la consulta.

Devolver:  

Este método devuelve el número de documentos que coinciden con los criterios de selección.

Ejemplos:

En los siguientes ejemplos, estamos trabajando con:

Base de datos: gfg

Colecciones: estudiante

Documento: Cuatro documentos contienen el nombre y la edad de los estudiantes .

• Cuente el número de documentos en la colección dada:

db.student.countDocuments({})

Aquí, estamos contando el número total de documentos presentes en la colección del estudiante.

• Cuente el número de documentos que coinciden con los criterios de selección dados:

db.student.countDocuments({age:{$gt:18}})

Aquí, estamos contando el número total de documentos en la colección del estudiante que coincide con la condición dada, es decir, la edad es mayor de 18 años.

Nota: Aquí, $gt significa mayor que