Bases de datos y colecciones

Overview

En esta guía, puede aprender a utilizar el controlador 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 documento, consulte Guía dedocumentos en el manual de MongoDB Server.

Acceder a una base de datos

Puede acceder a una base de datos llamando al 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");

Alternativamente, puede utilizar el operador [] en un mongocxx::client como abreviatura de 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");

Alternativamente, puede utilizar el operador [] en un mongocxx::database como abreviatura de la función collection(), como se muestra en el siguiente código:

auto coll = database["test_collection"];

Crear una colección

Puede utilizar 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");

Puede 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 de la create_collection() función. Para obtener una lista completa de parámetros opcionales, consulte la documentación del comando create en el manual de MongoDB Server.

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 función list_collections() e itera sobre 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 en la base de datos, llame 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

Puede eliminar una colección de la base de datos utilizando 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 escritura

Puede controlar cómo el controlador enruta las operaciones de lectura configurando una preferencia de lectura. También puede controlar cómo el controlador espera la confirmación de las operaciones de lectura y escritura en un conjunto de réplicas configurando una preocupación de lectura y una preocupación de escritura.

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 obtener más información sobre las configuraciones de lectura y escritura, consulte las siguientes guías en el manual de MongoDB Server:

• preferencia de lectura

• readConcern

• Nivel de confirmación de escritura

auto db = client["test_database"];
mongocxx::read_preference rp;
rp.mode(mongocxx::read_preference::read_mode::k_secondary);
mongocxx::read_concern rc;
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;
rc.acknowledge_level(mongocxx::read_concern::level::k_local);
mongocxx::write_concern wc;
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()

• lista_nombres_de_colección()

• drop()

• preferencia de lectura()

• leer_preocupación()

• escribir_preocupación()