Contabilizar documentos

Overview

En esta guía, aprenderá a contar el número de documentos en sus colecciones de MongoDB. Hay dos métodos de instancia en MongoCollection Clase que puedes llamar para contar la cantidad de documentos en una colección:

• countDocuments() Devuelve el número de documentos de la colección que coinciden con una consulta específica. Si se especifica un filtro de consulta vacío, el método devuelve el número total de documentos de la colección.

• estimatedDocumentCount() Devuelve una estimación del número de documentos de la colección según sus metadatos. No se puede especificar una consulta al usar este método.

El estimatedDocumentCount() método devuelve resultados más rápido que el countDocuments() método porque utiliza los metadatos de la colección en lugar de analizarla por completo. El countDocuments() método devuelve un recuento preciso del número de documentos y permite especificar un filtro.

CountOptions opts = new CountOptions().hintString("_id_");
long numDocuments = collection.countDocuments(new BsonDocument(), opts);

Al llamar al countDocuments() método, se puede pasar opcionalmente un parámetro de filtro de consulta. No se pueden pasar parámetros al llamar estimatedDocumentCount() a.

También puede pasar un parámetro opcional a cualquiera de estos métodos para especificar el comportamiento de la llamada:

Ambos métodos devuelven el número de documentos coincidentes como un primitivo long.

Ejemplo de recuento de documentos: expediente completo

El siguiente ejemplo estima la cantidad de documentos en la colección movies en la base de datos sample_mflix y luego devuelve un recuento preciso de la cantidad de documentos en la colección movies con Canada en el campo countries.

/**
 * This file demonstrates how to open a change stream by using the Java driver.
 * It connects to a MongoDB deployment, accesses the "sample_mflix" database, and listens
 * to change events in the "movies" collection. The code uses a change stream with a pipeline
 * to only filter for "insert" and "update" events.
 */
package usage.examples;
import static com.mongodb.client.model.Filters.eq;
import org.bson.Document;
import org.bson.conversions.Bson;
import com.mongodb.MongoException;
import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
public class CountDocuments {
    public static void main(String[] args) {
        // Replace the uri string with your MongoDB deployment's connection string
        String uri = "<connection string uri>";
        try (MongoClient mongoClient = MongoClients.create(uri)) {
            MongoDatabase database = mongoClient.getDatabase("sample_mflix");
            MongoCollection<Document> collection = database.getCollection("movies");
            Bson query = eq("countries", "Spain");
            // Retrieves and prints the estimated number of documents in the collection
            long estimatedCount = collection.estimatedDocumentCount();
            System.out.println("Estimated number of documents in the movies collection: " + estimatedCount);
            // Retrieves and prints the number of documents with a "countries" value of "Spain"
            long matchingCount = collection.countDocuments(query);
            System.out.println("Number of movies from Spain: " + matchingCount);
        }
    }
}

Si ejecuta el código de muestra anterior, debería ver un resultado parecido a esto (los números exactos pueden variar según sus datos):

Estimated number of documents in the movies collection: 23541
Number of movies from Spain: 755

Información Adicional