Conexão via Drivers
A caixa de diálogo Connect para um cluster fornece os detalhes para se conectar a um cluster com um aplicativo usando um driver do MongoDB.
Observação
As instâncias sem servidor não permitem conexão por meio de determinados drivers ou versões de drivers no momento. Para saber mais, consulte Limitações de instância sem servidor.
➤ Use o menu suspenso Selecione a linguagem para definir a linguagem do exemplo nesta página.
Pré-requisitos
Versão do driver
A versão do driver deve ser compatível com a versão do servidor MongoDB. Recomendamos escolher o driver mais recente compatível com a versão do servidor MongoDB para usar os recursos mais recentes do banco de dados e preparar-se para futuras atualizações de versão.
Para obter uma lista de versões de drivers que contêm o definir completo de funcionalidades para sua versão do servidor MongoDB, verifique a matriz de compatibilidade do seu driver MongoDB.
Para obter uma lista de versões de driver que você pode usar para se conectar a instâncias sem servidor, consulte Versões mínimas de driver para instâncias sem servidor.
Cadeias de conexão otimizadas para clusters fragmentados atrás de um ponto de extremidade privado
Para se conectar ao cluster fragmentado usando um driver e uma cadeia de conexão otimizada, você deve usar pelo menos uma das seguintes versões de driver:
TLS
Os clientes precisam suportar TLS para se conectarem a um Atlas cluster.
Os clientes devem suportar SNI Extensão TLS para se conectar a um M0
cluster gratuito Atlas ou M2/M5
cluster compartilhado . Para verificar se o driver do MongoDB é compatível com a extensão SNI TLS , consulte a seção "Compatibilidade" da documentação do driver. Se o driver for compatível com MongoDB 4.2 e posterior, ele suporta a extensão SNI TLS .
Lista de acesso IP
Para acessar um cluster, você deve se conectar a partir de um endereço IP na lista de acesso de IP do projeto Atlas. Se você precisar adicionar um endereço IP à lista de acesso IP, pode fazê-lo na caixa de diálogo Connect . Você também pode adicionar o endereço IP na aba Acesso à rede.
Usuário do banco de dados
Para acessar um cluster, é necessário criar um usuário de banco de dados com acesso aos bancos de dados desejados no Atlas cluster. Os utilizadores de banco de dados são separados dos Atlas users. Os usuários do banco de dados têm acesso aos bancos de dados MongoDB, enquanto os usuários Atlas têm acesso ao próprio aplicativo Atlas.
Você pode criar um utilizador de banco de dados para acessar seu Atlas cluster na caixa de diálogo Connect . Você também pode adicionar o usuário do banco de dados a partir da visualização do Cluster.
Conectar seu aplicativo
Escolha a conexão de segurança.
Choose Connection Type do conjunto de botões disponíveis.
Observação
As opções são exibidas se a funcionalidade estiver habilitada
O Atlas exibe as opções de tipo de conexão depois que você ativa o Private IP for Peering, o Private Endpoint ou ambos. Se você não tiver ativado nenhum desses recursos, nenhum botão será exibido e o padrão do Connection Type será Standard.
Crie um utilizador de banco de dados.
Importante
Pule esta etapa se o Atlas indicar na etapa Setup connection security que você tem pelo menos um usuário de banco de dados configurado no seu projeto. Para gerenciar usuários de banco de dados existentes, consulte Configurar usuários de banco de dados.
Para acessar o cluster, você precisa de um usuário MongoDB com acesso ao banco de dados desejado, ou aos bancos de dados no cluster em seu projeto. Se seu projeto não tiver usuários do MongoDB, o Atlas solicitará que você crie um novo usuário com o role de Atlas admin .
Insira o Username do novo usuário.
Insira um Password para esse novo usuário ou clique em Autogenerate Secure Password.
Clique em Create Database User para salvar o usuário.
Use esse usuário para se conectar ao seu cluster na etapa a seguir.
Após adicionar um endereço IP à sua lista de acesso IP e adicionar um usuário do banco de dados, clique em Choose Your Connection Method.
Selecione o Driver e a Versão.
Selecione o driver e a versão nos menus suspensos. A amostra de código contendo uma cadeia de conexão é exibida. Substitua <password>
pela senha especificada quando você criou seu usuário do banco de dados.
Observação
Se suas senhas, nomes de bancos de dados ou cadeias de conexão contiverem caracteres reservados de URI, você deverá trocar os caracteres. Por exemplo, se a sua senha for @bc123
, você deverá trocar o caractere @
ao especificar a senha na cadeia de conexão, como %40bc123
. Para saber mais, consulte Caracteres especiais na senha da cadeia de conexão.
Para saber mais, consulte Compatibilidade do driver.
Exemplos de driver
No exemplo a seguir, você autentica e se conecta a um Atlas cluster usando uma string de conexão URI. Substitua os espaços reservados no exemplo pelas suas credenciais e detalhes de sistema.
Solução de problemas
Se você estiver enfrentando problemas para se conectar ao cluster, consulte Solucionar problemas de conexão.