Página inicial do Docs → Iniciar e gerenciar o MongoDB → MongoDB Atlas
Conexão via Drivers
A caixa de diálogo Connect para um sistema de banco de dados fornece os detalhes para se conectar a um sistema de banco de dados 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 devem ser compatíveis com a TLS para se conectar a um sistema de banco de dados Atlas.
Os clientes devem suportar o SNI Extensão TLS para se conectar a um M0 cluster gratuito do 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 o MongoDB 4.2 e posterior, ele suporta a extensão SNI TLS .
Lista de acesso IP
Para acessar uma implantação de banco de dados, 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 sistema de banco de dados, é necessário criar um usuário de banco de dados com acesso aos bancos de dados desejados no sistema de banco de dados Atlas. 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 sistema de banco de dados do Atlas na caixa de diálogo Connect . Você também pode adicionar o usuário do banco de dados a partir da visualização Implementação do Banco de Dados.
Conectar seu aplicativo
Na interface de usuário do Atlas, selecione sua Implementação do Banco de Dados.
Clique em Database no canto superior esquerdo do Atlas.
Na visualização do Database Deployments, clique em Connect para o sistema de banco de dados ao qual você deseja se conectar.
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.
Escolha como você deseja limitar as conexões para o sistema de banco de dados.
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 sistema do banco de dados, você precisa de um usuário MongoDB com acesso ao banco de dados desejado, ou aos bancos de dados no sistema de banco de dados 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 sistema do seu banco de dados 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 Drivers.
Na etapa Choose a connection method, selecione Drivers.
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 uma implantação de banco de dados Atlas 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 estiver tendo problemas para se conectar ao sistema de banco de dados, consulte Solucionar problemas de conexão.