Crea un cliente de MongoDB

Overview

Para conectarte a una implementación de MongoDB, necesitas dos cosas:

Una URI de conexión, también conocida como cadena de conexión, que le indica al controlador de C++ a qué implementación de MongoDB conectarse.
Un objeto mongocxx::client, que crea la conexión a la implementación de MongoDB y le permite realizar operaciones en ella.

También puede utilizar cualquiera de estos componentes para personalizar la forma en que se comporta el controlador C++ mientras está conectado a MongoDB.

Esta guía le muestra cómo crear una cadena de conexión y utilizar una mongocxx::client objeto para conectarse a MongoDB.

Nota

mongocxx::instancia

Los ejemplos de código de esta página asumen que ya ha creado un objeto mongocxx::instance en otra parte de su aplicación.

Para obtener más información sobre cómo crear una instancia, consulte Crear una instancia de controlador.

URI de conexión

Una cadena de conexión estándar incluye los siguientes componentes:

Componente	Descripción
`mongodb://`	Requerido. Un prefijo que identifica esto como un string en el formato de conexión estándar.
`db_username:db_password`	Opcional. Credenciales de autenticación. Si las incluye, el cliente autentica al usuario contra la base de datos especificada en `authSource`. Para obtener más información sobre la opción de conexión `authSource`, consulta Mecanismos de autenticación.
`host[:port]`	Requerido. El host y el número de puerto opcional donde se ejecuta MongoDB. Si no incluyes el número de puerto, el controlador utiliza el puerto por defecto, `27017`.
`/defaultauthdb`	Opcional. La base de datos de autenticación que se debe usar si la cadena de conexión incluye las credenciales de autenticación `db_username:db_password@` pero no la opción `authSource`. Si no incluyes este componente, el cliente autentica al usuario contra la base de datos `admin`.
`?<options>`	Opcional. Un string del query que especifica opciones específicas de conexión como pares `<name>=<value>`. Consulta Opciones de conexión para obtener una descripción completa de estas opciones.

Para obtener más información sobre cómo crear una cadena de conexión, consulte Cadenas de conexión en la documentación del servidor MongoDB.

Crear una `mongocxx::client`

Para crear una conexión a MongoDB, construya una instancia de la clase mongocxx::uri y pase la URI de conexión como una cadena al constructor. Luego, pase la instancia de la clase mongocxx::uri al constructor mongocxx::client.

En el siguiente ejemplo, el driver utiliza un URI de conexión de muestra para conectarse a una implementación de MongoDB en el puerto 27017 de localhost:

#include <mongocxx/instance.hpp>
#include <mongocxx/uri.hpp>
#include <mongocxx/client.hpp>
int main()
{
    mongocxx::instance instance;
    mongocxx::uri uri("mongodb://localhost:27017");
    mongocxx::client client(uri);
}

Tip

Reutilizar el cliente

Debido a que cada objeto mongocxx::client representa un grupo de conexiones a la base de datos, la mayoría de las aplicaciones requiere solo una única instancia de mongocxx::client, incluso a través de múltiples solicitudes.

Documentación de la API

Para obtener más información sobre cómo crear un objeto mongocxx::client en el controlador C++, consulte la siguiente documentación de API:

mongocxx::cliente

Volver

Crear una instancia de controlador

Elija un destino de conexión