Overview
En esta guía, puede aprender cómo usar el controlador C para recuperar los valores distintos de un campo especificado en una colección.
Dentro de una colección, diferentes documentos pueden contener distintos valores para un mismo campo. Por ejemplo, un documento en la restaurant Una colección tiene un valor borough de "Manhattan" y otra tiene un valor borough de "Queens". Con el controlador de C, puede recuperar todos los valores distintos que contiene un campo en varios documentos de una colección.
Datos de muestra
Los ejemplos de esta guía usan la colección restaurants en la base de datos sample_restaurants de la Conjuntos de datos de muestra de Atlas. Para aprender a crear un clúster gratuito de MongoDB Atlas y cargar los conjuntos de datos de ejemplo, consulta la guía Introducción a MongoDB.
Comando Distinto
Para recuperar los valores distintos de un campo especificado, llama a la función mongoc_collection_read_command_with_opts() e indícale que use el comando distinct. También debe especificar la colección y el campo del que recuperar los datos.
Recuperar valores distintos en una colección
El siguiente ejemplo recupera los valores distintos del campo borough en la colección restaurants:
bson_t reply; bson_error_t error; bson_t *command = BCON_NEW("distinct", BCON_UTF8("restaurants"), "key", BCON_UTF8("borough")); if (!mongoc_collection_read_command_with_opts(collection, command, NULL, NULL, &reply, &error)) { fprintf(stderr, "An error occurred: %s\n", error.message); } else { char *str = bson_as_canonical_extended_json(&reply, NULL); printf("%s\n", str); bson_free(str); } bson_destroy(&reply); bson_destroy(command);
{ "values" : [ "Bronx", "Brooklyn", "Manhattan", "Missing", "Queens", "Staten Island" ], ... }
Los resultados muestran cada valor distinto que aparece en el campo borough en todos los documentos de la colección. Aunque varios documentos tienen el mismo valor en el campo borough, cada valor aparece en los resultados solo una vez.
Recupere valores distintos en documentos especificados
Puede proporcionar un filtro de query al comando distinct para encontrar los valores distintos de campo en un subconjunto de documentos dentro de una colección. Un filtro de query es una expresión que especifica los criterios de búsqueda utilizados para hacer coincidir documentos en una operación.
Para obtener más información sobre cómo crear filtros de consulta, consulte Especifica una query.
El siguiente ejemplo recupera los valores distintos del campo borough para todos los documentos que tienen un valor de campo cuisine de "Italian":
bson_t reply; bson_error_t error; bson_t *query = BCON_NEW("cuisine", BCON_UTF8("Italian")); bson_t *command = BCON_NEW("distinct", BCON_UTF8("restaurants"), "key", BCON_UTF8("borough"), "query", BCON_DOCUMENT(query)); if (!mongoc_collection_read_command_with_opts(collection, command, NULL, NULL, &reply, &error)) { fprintf(stderr, "An error occurred: %s\n", error.message); } else { char *str = bson_as_canonical_extended_json(&reply, NULL); printf("%s\n", str); bson_free(str); } bson_destroy(&reply); bson_destroy(command); bson_destroy(query);
{ "values" : [ "Bronx", "Brooklyn", "Manhattan", "Queens", "Staten Island" ], ... }
Modificar el comportamiento de Distinct
El comando distinct se puede modificar pasando opciones a la función mongoc_collection_read_command_with_opts(). Si no especificas ninguna opción, el driver no personaliza la operación.
La siguiente tabla describe algunas opciones que puedes utilizar para personalizar la operación distinct:
Opción | Descripción |
|---|---|
| Specifies the kind of language collation to use when sorting
results. For more information, see Collation
in the MongoDB Server manual. |
| Specifies a comment to attach to the operation. |
Para ver una lista completa de opciones que puede usar para modificar la operación distinct, consulte la documentación de Distinct en el manual de MongoDB Server.
El siguiente ejemplo recupera los valores distintos del campo name para todos los documentos que tengan un valor de campo borough de "Bronx" y un valor de campo cuisine de "Pizza". También utiliza la opción comment para añadir un comentario a la operación.
bson_t reply; bson_error_t error; bson_t *query = BCON_NEW("borough", BCON_UTF8("Bronx"), "cuisine", BCON_UTF8("Pizza")); bson_t *command = BCON_NEW("distinct", BCON_UTF8("restaurants"), "key", BCON_UTF8("name"), "query", BCON_DOCUMENT(query)); bson_t *opts = BCON_NEW("comment", BCON_UTF8("Bronx pizza restaurants")); if (!mongoc_collection_read_command_with_opts(collection, command, NULL, opts, &reply, &error)) { fprintf(stderr, "An error occurred: %s\n", error.message); } else { char *str = bson_as_canonical_extended_json(&reply, NULL); printf("%s\n", str); bson_free(str); } bson_destroy(&reply); bson_destroy(command); bson_destroy(query); bson_destroy(opts);
{ "values" : [ "$1.25 Pizza", "18 East Gunhill Pizza", "2 Bros", "Aenos Pizza", "Alitalia Pizza Restaurant", ... ], ... }
Información Adicional
Para obtener más información sobre el comando distinto, consulta la Distinct página en el Manual de MongoDB Server.
Documentación de la API
Para obtener más información sobre la función mongoc_collection_read_command_with_opts(), consulta la documentación de la API.