Contabilizar documentos

Datos de muestra

Los ejemplos de esta guía utilizan la colección restaurants en la base de datos sample_restaurants de los conjuntos de datos de ejemplo de Atlas. Para acceder a esta colección desde tu aplicación Rust, crea un Client que se conecte a un clúster de Atlas y asigna los siguientes valores a tu variable my_coll.

Selecciona la pestaña Asynchronous o Synchronous para ver el código correspondiente para cada runtime:

let uri = "<connection string>";
let client = Client::with_uri_str(uri).await?;
let my_coll: Collection<Document> = client
    .database("sample_restaurants")
    .collection("restaurants");

let uri = "<connection string>";
let client = Client::with_uri_str(uri)?;
let my_coll: Collection<Document> = client
    .database("sample_restaurants")
    .collection("restaurants");

Para aprender a crear un clúster gratuito de MongoDB Atlas y cargar los conjuntos de datos de muestra, consulta la guía Get Started with the Rust Driver.

Los ejemplos en esta guía usan la siguiente estructura Restaurant como modelo para documentos en la colección restaurants:

#[derive(Serialize, Deserialize, Debug)]
struct Restaurant {
    name: String,
    cuisine: String,
}

Contar todos los documentos

Para devolver un recuento de todos los documentos en la colección, pasa un documento de filtro vacío al método count_documents() como se muestra en el siguiente ejemplo. Selecciona la pestaña Asynchronous o Synchronous para ver el código correspondiente para cada entorno de ejecución:

let ct = my_coll.count_documents().await?;
println!("Number of matching documents: {}", ct);

Number of documents: 25216

let ct = my_coll.count_documents().run()?;
println!("Number of matching documents: {}", ct);

Number of documents: 25216

Contar documentos específicos

Para devolver un conteo de documentos que coincidan con criterios de búsqueda específicos, pasa tu documento de filtro de query al método count_documents().

El siguiente ejemplo cuenta el número de documentos en los que el valor del campo name incluye la string "Sunset". Selecciona la pestaña Asynchronous o Synchronous para ver el código correspondiente de cada runtime:

let ct = my_coll
    .count_documents(doc! { "name": doc! { "$regex": "Sunset" } })
    .await?;
println!("Number of matching documents: {}", ct);

Number of matching documents: 10

let ct = my_coll
    .count_documents(doc! { "name": doc! { "$regex": "Sunset" } })
    .run()?;
println!("Number of matching documents: {}", ct);

Number of matching documents: 10

Personalizar el comportamiento de recuento

Puedes modificar el comportamiento del método count_documents() encadenando métodos de opciones a tu llamada count_documents() antes de la llamada a los métodos await o run(). La siguiente tabla describe las opciones que se pueden configurar para personalizar la operación de conteo:

Personaliza el comportamiento de conteo estimado

Puedes modificar el comportamiento del método estimated_document_count() encadenando métodos de opciones a tu estimated_document_count() llamar. La siguiente tabla describe las opciones que puedes configurar para personalizar la operación de recuento estimado: