Comienza con el controlador C

Cree una implementación gratuita de MongoDB en Atlas.

Completa la Guía de inicio de MongoDB para configurar una nueva cuenta de Atlas y cargar datos de muestra en una nueva implementación de MongoDB de nivel gratuito.

Guarda tus credenciales.

Después de crear un usuario de base de datos, guardar el nombre de usuario y la contraseña de ese usuario en una ubicación segura para usarlos en un paso próximo.

Encuentra tu cadena de conexión de MongoDB Atlas.

Para recuperar su cadena de conexión para la implementación que creó en el paso anterior, inicie sesión en su cuenta de Atlas y navegue hasta la Clusters Página en la sección Database. Haga clic en el botón Connect para su nueva implementación.

Si aún no tienes un usuario de base de datos configurado, MongoDB te pedirá que crees y configures un nuevo usuario.

Haga clic en el botón Drivers en la sección Connect to your application y seleccione "C" en el menú de selección Driver y la versión que mejor coincida con la versión que instaló en el menú de selección Version.

Asegúrate de que la opción View full code sample esté desmarcada para ver solo la cadena de conexión.

Copie su cadena de conexión.

Haz clic en el botón a la derecha de la cadena de conexión para copiarla en el portapapeles, como se muestra en la siguiente captura de pantalla:

Actualiza el marcador de posición de la contraseña.

Pega esta cadena de conexión en un archivo en tu editor de texto preferido y reemplaza el marcador de posición <db_password> con la contraseña de tu usuario de base de datos. La cadena de conexión ya está completada con el nombre de usuario de tu usuario de base de datos.

Guarda este archivo en una ubicación segura para usarlo en el siguiente paso.

Crea un directorio de proyecto.

En su shell, navegue hasta donde desea crear su aplicación, luego ejecute el siguiente comando para crear un directorio llamado c-quickstart para este proyecto:

mkdir c-quickstart

Seleccione la pestaña correspondiente a su sistema operativo y ejecute los siguientes comandos para crear un archivo de aplicación quickstart.c en el directorio c-quickstart:

cd c-quickstart
touch quickstart.c

cd c-quickstart
type nul > quickstart.c

Cree su aplicación C Driver.

Copie y pegue el siguiente código en el archivo quickstart.c, que hace un query en la colección movies en la base de datos sample_mflix:

#include <bson/bson.h>
#include <mongoc/mongoc.h>
#include <stdio.h>
int
main(void)
{
    const bson_t *doc;
    mongoc_init();
    mongoc_client_t *client = mongoc_client_new("<connection string>");
    mongoc_collection_t *collection = mongoc_client_get_collection(client, "sample_mflix", "movies");
    // Specify the query filter
    bson_t *query = BCON_NEW("title", "The Shawshank Redemption");
    mongoc_cursor_t *results = mongoc_collection_find_with_opts(collection, query, NULL, NULL);
    // Print the results
    while (mongoc_cursor_next(results, &doc))
    {
        char* str = bson_as_canonical_extended_json(doc, NULL);
        printf("%s\n", str);
        bson_free(str);
    }
    bson_destroy(query);
    mongoc_cursor_destroy(results);
    mongoc_collection_destroy(collection);
    mongoc_client_destroy(client);
    mongoc_cleanup();
    return EXIT_SUCCESS;
}

Asigna la cadena de conexión.

Reemplaza el marcador de posición <connection string> con la cadena de conexión que se copió del paso Crear una cadena de conexión de esta guía.

Configurar una aplicación CMake.

Para configurar su aplicación, cree un archivo CMakeLists.txt en el directorio de su proyecto. A continuación, añada el siguiente código al archivo:

cmake_minimum_required(VERSION 3.11)
project(c-quickstart LANGUAGES C)
add_executable (quickstart.out quickstart.c)
find_package(mongoc <version> REQUIRED)
target_link_libraries(quickstart.out mongoc::mongoc)

El código precedente realiza las siguientes acciones:

• Configura un proyecto de C.

• Crea un ejecutable quickstart.out para la aplicación.

• Busca y requiere el controlador C. Reemplace el marcador de posición <version> con el número de versión de su controlador C, como 2.2.2.

• Vincula el programa a la biblioteca libmongoc.

Ejecute su aplicación C.

En su shell, ejecute los siguientes comandos para compilar y ejecutar esta aplicación:

cmake -S. -Bcmake-build
cmake --build cmake-build --target quickstart.out
./cmake-build/quickstart.out

La salida de la línea de comandos contiene detalles sobre el documento de película recuperado:

{ "_id" : { "$oid" : "..." },
"plot" : "Two imprisoned men bond over a number of years, finding solace
and eventual redemption through acts of common decency.",
...
"title" : "The Shawshank Redemption",
...

Si encuentras un error o no ves ninguna salida, asegúrate de haber especificado la cadena de conexión correcta en el archivo quickstart.c y de haber cargado los datos de muestra.