Criar um cliente MongoDB
Visão geral
Para se conectar a um MongoDB deployment, você precisa de duas coisas:
Um URI de conexão, também conhecido como string de conexão, que informa ao driver C++ a qual sistema do MongoDB se conectar.
Um objeto mongocxx:: cliente , que cria a conexão com a implantação do MongoDB e permite que você execute operações nele.
Você também pode usar qualquer um desses componentes para personalizar a maneira como o driver C++ se comporta enquanto conectado ao MongoDB.
Este guia mostra como criar uma connection string e utilizar um objeto mongocxx::client para conectar ao MongoDB.
Observação
mongocxx::instance
Os exemplos de código nesta página pressupõem que você já criou um objeto mongocxx::instance em outro lugar em seu aplicação.
Para saber mais sobre como criar uma instância, consulte Criar uma Instância de Driver.
URI de conexão
Uma connection string padrão inclui os seguintes componentes:
Componente | Descrição |
|---|---|
mongodb:// | Obrigatório. Um prefixo que identifica isso como uma string no formato de conexão padrão. |
db_username:db_password | Opcional. Credenciais de autenticação. Se você incluir estes, o cliente autenticará o usuário no banco de banco de dados especificado no authSource. Para obter mais informações sobre a opção de conexão authSource , consulte Mecanismos de autenticação. |
host[:port] | Obrigatório. O host e o número da porta opcional em que o MongoDB está sendo executado. Se você não incluir o número da porta, o driver usará a porta padrão, 27017. |
/defaultauthdb | Opcional. O authentication database de autenticação a ser usado se a connection string incluir as credenciais de autenticação db_username:db_password@ , mas não a opção authSource . Se você não incluir este componente, o cliente autenticará o usuário no banco de dados do admin . |
?<options> | Opcional. Uma string de consulta que especifica opções específicas de conexão como <name>=<value> pares. Consulte Especificar opções de conexão para obter uma descrição completa dessas opções. |
Para obter mais informações sobre a criação de uma connection string, consulte connection strings na documentação do MongoDB Server .
Crie um mongocxx::client
Para criar uma conexão com o MongoDB, construa uma instância da classe mongocxx::uri , passando o URI de conexão como uma string para o construtor. Em seguida, passe a instância da classe mongocxx::uri para o construtor mongocxx::client .
No exemplo a seguir, o driver usa um URI de conexão de exemplo para se conectar a uma implementação do MongoDB na porta 27017 de localhost:
int main() { mongocxx::instance instance; mongocxx::uri uri("mongodb://localhost:27017"); mongocxx::client client(uri); }
Dica
Reutilize seu cliente
Como cada objeto mongocxx::client representa um pool de conexões com o banco de dados de dados, a maioria dos aplicativos exige somente uma única instância de mongocxx::client, mesmo em várias solicitações.
Documentação da API
Para saber mais sobre como criar um objeto mongocxx::client no driver C++ , consulte a seguinte documentação da API: