Menu Docs
Página inicial do Docs
/
Idiomas
/
C++
/
Driver C++
/
Conecte-se ao MongoDB

Criar um cliente MongoDB

Nesta página

  • Visão geral
  • URI de conexão
  • Crie um mongocxx::client
  • Documentação da API

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:

#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);
}

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:

Voltar

Criar uma instância do driver

Próximo

Escolha um destino de conexão