Bases de datos y colecciones

Overview

En esta guía, aprenderás a utilizar el driver C++ para interactuar con bases de datos y colecciones de MongoDB.

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 y la estructura de los campos de documentos, consulta el Documentos guía en el manual de MongoDB Server.

Acceder a una base de datos

Puedes acceder a una base de datos llamando a la database() función en un objeto mongocxx::client y pasando el nombre de la base de datos como argumento.

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

auto db = client.database("test_database");

Como alternativa, puedes utilizar el operador [] en un mongocxx::client como una abreviatura para la función database(), como se muestra en el siguiente código:

auto db = client["test_database"];

Acceder a una colección

Puede acceder a una colección llamando a la función collection() en un objeto mongocxx::database y pasando el nombre de la colección como argumento.

El siguiente ejemplo accede a una colección llamada test_collection:

auto coll = database.collection("test_collection");

Como alternativa, puedes utilizar el operador [] en un mongocxx::database como una abreviatura para la función collection(), como se muestra en el siguiente código:

auto coll = database["test_collection"];

Crear una colección

Puedes usar la función 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:

auto coll = database.create_collection("example_collection");

Puedes especificar opciones de colección, como el tamaño máximo y las reglas de validación de documentos, pasándolas dentro de un documento BSON como segundo parámetro a la función create_collection(). Para obtener una lista completa de los parámetros opcionales, consulte la documentación del comando create en el manual del servidor MongoDB.

Obtén una lista de colecciones

Puede recuperar una lista de colecciones en una base de datos llamando a la función list_collections(). Esta 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 list_collections() función y recorre el cursor para imprimir los resultados:

auto cursor = database.list_collections();
for(auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

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

Para consultar solo los nombres de las colecciones de la base de datos, llama a la función list_collection_names() como se muestra en el siguiente ejemplo:

auto list = database.list_collection_names();
for(auto&& name : list) {
    std::cout << name << std::endl;
}

test_collection
example_collection

Para obtener más información sobre cómo iterar sobre un cursor, consulte la Guíade acceso a datos desde un cursor.

Borrar una colección

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

El siguiente ejemplo elimina la colección test_collection:

auto coll = database["test_collection"];
coll.drop();

Borrar una base de datos

Puede eliminar una base de datos de su clúster utilizando la función drop().

El siguiente ejemplo borra la base de datos test_database:

auto db = client["test_database"];
db.drop();

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 estas configuraciones del objeto mongocxx::client y las colecciones las heredan de la base de datos. Sin embargo, puedes cambiar estos ajustes utilizando una de las siguientes funciones en tu base de datos o colección:

• read_preference()

• read_concern()

• write_concern()

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

• preferencia de lectura

• readConcern

• Nivel de confirmación de escritura

auto db = client["test_database"];
mongocxx::read_preference rp;
mongocxx::read_concern rc;
rp.mode(mongocxx::read_preference::read_mode::k_secondary);
rc.acknowledge_level(mongocxx::read_concern::level::k_majority);
db.read_preference(rp);
db.read_concern(rc);

auto coll = client["test_database"]["test_collection"];
mongocxx::read_concern rc;
mongocxx::write_concern wc;
rc.acknowledge_level(mongocxx::read_concern::level::k_local);
wc.acknowledge_level(mongocxx::write_concern::level::k_acknowledged);
coll.read_concern(rc);
coll.write_concern(wc);

auto tag_set_ny = make_document(kvp("dc", "ny"));
auto tag_set_sf = make_document(kvp("dc", "sf"));
mongocxx::read_preference rp;
rp.mode(mongocxx::read_preference::read_mode::k_secondary);
rp.tags(make_array(tag_set_ny, tag_set_sf).view());

mongocxx::uri uri{"mongodb://localhost:27017/?localThresholdMS=35"};
mongocxx::client client{uri};

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:

• database()

• colección()

• create_collection()

• list_collections()

• list_collection_names()

• drop()

• read_preference()

• leer_preocupación()

• escribir_preocupación()