Especifica los documentos a devolver

Overview

En esta guía, puede aprender a especificar qué documentos devolver de una operación de lectura mediante las siguientes operaciones:

• limit: Especifica el número máximo de documentos que se pueden devolver de una query

• sortEspecifica el orden de clasificación para los documentos devueltos

• skip: Especifica la cantidad de documentos a omitir antes de devolver los resultados de la query

Limit

Para especificar la cantidad máxima de documentos devueltos de una operación de lectura, pase la opción limit a su llamada de función mongoc_collection_find_with_opts().

El siguiente ejemplo encuentra todos los restaurantes que tienen un valor de campo cuisine de "Italian" y limita los resultados a 5 documentos:

const bson_t *doc;
bson_t *filter = BCON_NEW("cuisine", BCON_UTF8("Italian"));
bson_t *opts = BCON_NEW("limit", BCON_INT64(5));
mongoc_cursor_t *results =
    mongoc_collection_find_with_opts(collection, filter, opts, NULL);
while (mongoc_cursor_next(results, &doc)) {
    char *str = bson_as_canonical_extended_json(doc, NULL);
    printf("%s\n", str);
    bson_free(str);
}
bson_destroy(filter);
bson_destroy(opts);
mongoc_cursor_destroy(results);

{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "V & T Restaurant", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Mimis Restaurant & Bar", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Venice Restaurant", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Areo Restaurant", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Tre Giovani Pizza & Pasta", ... }

Sort

Para devolver documentos en un orden especificado, utiliza la opción sort. La opción sort toma una dirección de ordenación como parámetro. Para especificar la dirección de la ordenación, pasa un 1 para una ordenación ascendente o un -1 para una descendente. Los valores de ordenación ascendente se ordenan de menor a mayor, y los valores de ordenación descendente se ordenan de mayor a menor.

El siguiente ejemplo devuelve todos los documentos con un valor del campo cuisine de "Italian", ordenados por el valor del campo name en orden ascendente:

const bson_t *doc;
bson_t *filter = BCON_NEW("cuisine", BCON_UTF8("Italian"));
bson_t *opts = BCON_NEW("sort", "{", "name", BCON_INT32(1), "}");
mongoc_cursor_t *results =
    mongoc_collection_find_with_opts(collection, filter, opts, NULL);
while (mongoc_cursor_next(results, &doc)) {
    char *str = bson_as_canonical_extended_json(doc, NULL);
    printf("%s\n", str);
    bson_free(str);
}
bson_destroy(filter);
bson_destroy(opts);
mongoc_cursor_destroy(results);

{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "(Lewis Drug Store) Locanda Vini E Olii", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "101 Restaurant And Bar", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "44 Sw Ristorante & Bar", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "900 Park", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "A Voce", ... }
...

Omitir

Para omitir un número específico de documentos antes de devolver los resultados de la consulta, utilice la opción skip e indique el número de documentos que desea omitir. La opción skip ignora el número especificado de documentos en los resultados de la consulta y devuelve el resto.

El siguiente ejemplo devuelve todos los documentos que tienen un valor de campo cuisine de "Italian" y omite los primeros 10 documentos:

const bson_t *doc;
bson_t *filter = BCON_NEW("cuisine", BCON_UTF8("Italian"));
bson_t *opts = BCON_NEW("skip", BCON_INT64(10));
mongoc_cursor_t *results =
    mongoc_collection_find_with_opts(collection, filter, opts, NULL);
while (mongoc_cursor_next(results, &doc)) {
    char *str = bson_as_canonical_extended_json(doc, NULL);
    printf("%s\n", str);
    bson_free(str);
}
bson_destroy(filter);
bson_destroy(opts);
mongoc_cursor_destroy(results);

{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Trattoria Alba", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Da Umberto Restaurant", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "La Strada Restaurant", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Pasta Lovers Trattoria", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Nanni Restaurant", ... }
...

Combine Limit, Sort y Skip

Puedes combinar las opciones limit, sort y skip en una sola operación. Esto permite establecer un número máximo de documentos ordenados para devolver, omitiendo un número especificado de documentos antes de la devolución.

El siguiente ejemplo devuelve documentos con el valor del campo cuisine igual a "Italian". Los resultados se ordenan alfabéticamente, omitiendo los primeros 10 documentos y limitando los resultados a 5 documentos:

const bson_t *doc;
bson_t *filter = BCON_NEW("cuisine", BCON_UTF8("Italian"));
bson_t *opts = BCON_NEW("limit", BCON_INT64(5),
                        "skip", BCON_INT64(10), 
                        "sort", "{", "name", BCON_INT32(1), "}");
                        
mongoc_cursor_t *results =
    mongoc_collection_find_with_opts(collection, filter, opts, NULL);
while (mongoc_cursor_next(results, &doc)) {
    char *str = bson_as_canonical_extended_json(doc, NULL);
    printf("%s\n", str);
    bson_free(str);
}
bson_destroy(filter);
bson_destroy(opts);
mongoc_cursor_destroy(results);

{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Acqua", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Acqua Restaurant", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Acqua Santa", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Acquista Trattoria", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Acquolina Catering", ... }

Información Adicional

Para más información sobre cómo especificar una query, ver Especifica una query.

Para más información sobre cómo recuperar documentos, visita Buscar documentos.