Bases de datos y colecciones

Overview

En esta guía, puede aprender a interactuar con bases de datos y colecciones de MongoDB utilizando el controlador C.

MongoDB organiza los datos en una jerarquía de los siguientes niveles:

• Bases de datos: Estructuras de datos de nivel superior en una implementación de MongoDB que almacenan colecciones.

• Colecciones: Grupos de documentos de MongoDB. Son análogos a las tablas en bases de datos relacionales.

• Documentos: Unidades que almacenan datos literales como cadenas, números, fechas y otros documentos incrustados. Para obtener más información sobre los tipos de campos de documentos y la estructura, consulta la guía Documentos en el manual de MongoDB Server.

Acceder a una base de datos

Acceda a una base de datos utilizando la función mongoc_client_get_database().

El siguiente ejemplo accede a una base de datos llamada test_database:

mongoc_database_t *database = mongoc_client_get_database(client, "test_database");

Acceder a una colección

Accede a una colección utilizando las funciones mongoc_client_get_collection() o mongoc_database_get_collection().

El siguiente ejemplo accede a una colección llamada test_collection utilizando la función mongoc_database_get_collection():

mongoc_collection_t *collection = mongoc_database_get_collection(database, "test_collection");

Crear una colección

Utiliza la función mongoc_database_create_collection() para crear explícitamente una colección en una base de datos MongoDB.

El siguiente ejemplo crea una colección llamada example_collection:

mongoc_collection_t *new_collection = mongoc_database_create_collection(database, "example_collection", NULL, &error);

Puedes especificar las opciones de colección, como el tamaño máximo y las reglas de validación de documentos, pasándolas dentro de una estructura bson_t como el tercer parámetro de la función mongoc_database_create_collection(). Para obtener una lista completa de parámetros opcionales, consulte la documentación del comando create en el manual del MongoDB Server.

Obtén una lista de colecciones

Puedes query una lista de colecciones en una base de datos llamando a la función mongoc_database_find_collections_with_opts(). La función devuelve un cursor que contiene todas las colecciones de la base de datos y sus metadatos asociados.

El siguiente ejemplo llama a la mongoc_database_find_collections_with_opts() función y recorre el cursor para imprimir los resultados:

mongoc_cursor_t *cursor = mongoc_database_find_collections_with_opts(database, NULL);
const bson_t *doc;
while (mongoc_cursor_next(cursor, &doc))
{
    char *str = bson_as_canonical_extended_json(doc, NULL);
    printf("Collection: %s\n", str);
    bson_free(str);
}

Collection: { "name" : "test_collection", "type" : "collection", ...}
Collection: { "name" : "example_collection", "type" : "collection", ... }

Para realizar una query únicamente los nombres de las colecciones en la base de datos, llama a la función mongoc_database_get_collection_names_with_opts() de la siguiente manera:

char **strv;
unsigned i;
if ((strv = mongoc_database_get_collection_names_with_opts(database, NULL, &error)))
{
    for (i = 0; strv[i]; i++)
        printf("%s\n", strv[i]);
    bson_strfreev(strv);
}
else
{
    fprintf(stderr, "Command failed: %s\n", error.message);
}

test_collection
example_collection

Para obtener más información sobre cómo iterar sobre un cursor, consulta Acceder a los datos desde un cursor.

Borrar una colección

Puedes borrar una colección de la base de datos usando la función mongoc_collection_drop().

El siguiente ejemplo elimina la colección test_collection:

mongoc_collection_t *collection = mongoc_database_get_collection(database, "test_collection");
mongoc_collection_drop(collection, NULL);

Borrar una base de datos

Puedes borrar una base de datos de tu clúster utilizando la función de mongoc_database_drop().

El siguiente ejemplo borra la base de datos test_database:

mongoc_database_t *database = mongoc_client_get_database(client, "test_database");
mongoc_database_drop(database, NULL);

Configurar operaciones de lectura y guardar

Puedes controlar cómo el driver direcciona las operaciones de lectura configurando una preferencia de lectura. También puede controlar las opciones de cómo el driver espera la confirmación de las operaciones de lectura y escritura en un set de réplicas configurando un nivel de consistencia de lectura y un nivel de confirmación de escritura (write concern).

Por defecto, las bases de datos heredan esta configuración de la instancia mongoc_client_t y las colecciones la heredan de la base de datos. Sin embargo, puedes cambiar esta configuración en tu base de datos utilizando una de las siguientes funciones:

• mongoc_database_set_read_prefs()

• mongoc_database_set_read_concern()

• mongoc_database_set_write_concern()

El siguiente ejemplo muestra cómo cambiar la preferencia de lectura de una base de datos utilizando la función mongoc_database_set_read_prefs():

mongoc_read_prefs_t *read_prefs = mongoc_read_prefs_new(MONGOC_READ_PRIMARY_PREFERRED);
mongoc_database_set_read_prefs(database, read_prefs);

Puedes cambiar la configuración de lectura y guardado en tus colecciones utilizando una de las siguientes funciones:

• mongoc_collection_set_read_prefs()

• mongoc_collection_set_read_concern()

• mongoc_collection_set_write_concern()

El siguiente ejemplo muestra cómo cambiar la preferencia de lectura de una colección usando la función mongoc_collection_set_read_prefs():

mongoc_read_prefs_t *read_prefs = mongoc_read_prefs_new(MONGOC_READ_PRIMARY_PREFERRED);
mongoc_collection_set_read_prefs(collection, read_prefs);

Para obtener más información sobre la configuración de lectura y escritura, consulta las siguientes guías en el manual del servidor MongoDB:

• preferencia de lectura

• readConcern

• Nivel de confirmación de escritura

Para obtener más información sobre las opciones que puedes configurar para ajustar el comportamiento de selección de servidores, consulta Opciones de selección y descubrimiento de servidores en el manual del servidor MongoDB.

mongoc_read_prefs_t *read_prefs = mongoc_read_prefs_new(MONGOC_READ_SECONDARY_PREFERRED);
bson_t *tags = BCON_NEW("DC", BCON_UTF8("ny"), "DC", BCON_UTF8("sf"));

const char *uri_string = "mongodb://localhost:27017/?localThresholdMS=35";
mongoc_client_t *client = mongoc_client_new(uri_string);

Documentación de la API

Para aprender más sobre alguna de las funciones tratadas en esta guía, consulta la siguiente documentación de la API:

• mongoc_database_create_collection()

• mongoc_database_find_collections_with_opts()

• mongoc_database_get_collection_names_with_opts()

• mongoc_client_get_database()

• mongoc_client_get_collection()

• mongoc_database_get_collection()

• mongoc_collection_drop()

• mongoc_database_drop()

• mongoc_database_set_read_prefs()

• mongoc_database_set_read_concern()

• mongoc_database_set_write_concern()

• mongoc_collection_set_read_prefs()

• mongoc_collection_set_read_concern()

• mongoc_collection_set_write_concern()

• mongoc_read_prefs_set_tags()