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 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âncias sem servidor.
➤ Use o menu suspenso Selecione a linguagem para definir a linguagem do exemplo nesta página.
Pré-requisitos
Importante
Limitação de Cluster Dedicado
Se você executar o driver C# com .NET 5.0 no Linux, não poderá se conectar ao MongoDB 4.0 em clusters dedicados no Atlas. Esse problema aplica-se apenas aos clusters dedicados do Atlas. Esse problema não afeta os níveis de cluster M0 a M5. Se você estiver usando uma versão anterior do .NET ou .NET Core e desejar atualizar para .NET 5.0, entre em contato com o suporte do MongoDB Atlas.
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 oferecer suporte a TLS para se conectar a um cluster do Atlas.
Os clientes devem suportar a extensão SNI TLS para se conectar a um cluster M0 gratuito do Atlas ou cluster M2/M5 compartilhado. Para verificar se seu driver MongoDB suporta a extensão SNI TLS, consulte a seção de Compatibilidade da documentação dele. 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 um cluster, você deve se conectar a partir de um endereço IP na lista de acesso IP do projeto do 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 do Atlas, é necessário criar um usuário de banco de dados com acesso aos bancos de dados desejados no cluster do Atlas. Os usuários de banco de dados são separados dos usuários do Atlas. Os usuários do banco de dados têm acesso aos bancos de dados MongoDB, enquanto os usuários do Atlas têm acesso ao próprio aplicativo Atlas.
Você pode criar um usuário de banco de dados para acessar seu cluster 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 Cluster.
Conectar seu aplicativo
No Atlas, váGo para a Clusters página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se ainda não estiver exibido, clique em Clusters na barra lateral.
A página Clusters é exibida.
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.
Use este tipo de conexão para endereços IP públicos permitidos.
Use esse tipo de conexão se você tiver ativado o emparelhamento:
Para o Google Cloud ou Azure e estão se conectando com seu driver a partir de uma rede emparelhada, ou
Para a AWS e estão se conectando com seu driver a partir de uma rede emparelhada que usa um serviço de DNS personalizado.
Se nenhuma dessas opções se aplicar, adicione seu endereço IP à lista de acesso IP e use a string de conexão padrão. Se estiver se conectando diretamente ao Atlas de uma rede doméstica ou da empresa, essa pode ser a opção mais adequada.
Observação
O emparelhamento deve estar disponível
Você não pode selecionar esta opção a menos que um de seus pares esteja marcado como AVAILABLE. Para verificar o status dos seus pares:
No Atlas, acesse a página Network Access do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.
Na barra lateral, clique em Network Access sob o título Security.
A página Acesso à rede é exibida.
Observação
Clusters Multinuvem
Se seu aplicativo não estiver hospedado no mesmo provedor de serviços de nuvem que o primário do cluster, o aplicativo só poderá realizar leituras secundárias.
Com clusters multinuvem, você pode adicionar a opção de conexão readPreference à sua string de conexão. Use um dos seguintes valores:
Utilize a string de conexão para o ponto de extremidade da interface apropriado se estiver conectando com seu driver através de uma conexão de pontos de extremidade privados, seja porque seu driver:
É executado dentro da rede do seu provedor de nuvem ou
Tem acesso de rede transitivo para a rede do seu provedor de nuvem .
Recomenda-se usar uma string de conexão otimizada.
Se nenhuma dessas opções se aplicar, adicione seu endereço IP à lista de acesso IP e use a string de conexão padrão. Se estiver se conectando diretamente ao Atlas de uma rede doméstica ou da empresa, essa pode ser a opção mais adequada.
Observação
Você não pode selecionar esta opção a menos que sua conexão PrivateLink configurada esteja pronta para uso. Para verificar o status do seu AWS PrivateLink:
No Atlas, acesse a página Network Access do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.
Na barra lateral, clique em Network Access sob o título Security.
A página Acesso à rede é exibida.
Escolha como você deseja limitar as conexões com seu cluster.
Add a Connection IP Address
Importante
Pule esta etapa se o Atlas indicar na etapa Setup connection security que você já configurou uma entrada da lista de acesso IP no seu cluster. Para gerenciar a lista de acesso IP, consulte Adicionar entradas à lista de acesso.
O Atlas permite conexões de cliente padrão com o cluster a partir de entradas na lista de acesso IP do projeto. A lista de acesso IP do projeto é diferente da lista de acesso à API, que restringe o acesso à API a endereços IP ou CIDR específicos.
Se a lista de acesso IP estiver vazia, o Atlas solicitará que você adicione um endereço IP à lista de acesso IP do projeto. Você também pode:
Clique em Add Your Current IP Address para permitir o acesso do seu endereço IP atual.
Clique em Add an IP Address para adicionar um endereço IP único ou uma faixa de endereços especificada usando a notação CIDR.
Forneça uma descrição opcional para o novo endereço IP adicionado ou faixa CIDR. Clique em Add IP Address para adicionar o endereço à lista de acesso IP.
Add a Connection IP Address
Importante
Pule esta etapa se o Atlas indicar na etapa Setup connection security que você já configurou uma entrada da lista de acesso IP no seu cluster. Para gerenciar a lista de acesso IP, consulte Adicionar entradas à lista de acesso IP.
O Atlas permite conexões de cliente padrão com o cluster a partir de entradas na lista de acesso IP do projeto. A lista de acesso IP do projeto é diferente da lista de acesso à API, que restringe o acesso à API a endereços IP ou CIDR específicos.
Se a lista de acesso IP estiver vazia, o Atlas solicitará que você adicione um endereço IP à lista de acesso IP do projeto. Clique em Add a Different IP Address para adicionar um endereço IP único ou uma faixa de endereços especificada usando a notação CIDR.
Forneça uma descrição opcional para o novo endereço IP adicionado ou faixa CIDR. Clique em Add IP Address para adicionar o endereço à lista de acesso IP.
Em Choose Connection Type, selecione Private Endpoint.
Se você vir as opções Private Link Type, selecione uma das seguintes opções:
Optimized SRV Connection para conexões com balanceamento de carga.
Legacy SRV Connection para conexões sem balanceamento de carga.
Para saber mais, consulte Melhorar o desempenho da conexão para clusters fragmentados por trás de um endpoint privado.
Em Choose Private Endpoint, selecione o endpoint que deseja usar.
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 do MongoDB com acesso ao banco de dados ou bancos de dados desejados 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 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 cluster do Atlas usando uma string de conexão URI. Substitua os espaços reservados no exemplo pelas suas credenciais e detalhes de implantação.
Observação
Para se conectar a um cluster gratuito do Atlas M0 ou cluster compartilhado M2/M5, você deve usar uma versão de driver C que ofereça suporte ao MongoDB 4.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver C e o MongoDB, veja a array de compatibilidade do MongoDB. Recomendamos que você atualize para a versão mais recente do driver.
client = mongoc_client_new ("mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority"); db = mongoc_client_get_database (client, "<databaseName>");
Versão do MongoDB | Versões de driver recomendadas |
|---|---|
Todos | Consulte a matriz de compatibilidade do MongoDB para obter as versões de driver recomendadas mais recentes. |
MongoDB 5.0 e posterior | Versão 1,11 e posterior |
Comportamento
Observação
As opções de configuração a seguir só se aplicam se o driver C for executado no modo de thread único.
Os drivers do MongoDB tentam automaticamente a seleção do servidor após uma eleição de cluster ou evento de failover. Por padrão, o driver C gera imediatamente um erro se a primeira tentativa de selecionar um servidor falhar. As seguintes definições de configuração podem melhorar a conectividade do aplicativo com um Atlas cluster, embora isso possa resultar em maior tempo gasto no processo de seleção do servidor:
Defina serverSelectionTryOnce como
falsepara direcionar o driver C a executar a seleção do servidor até o limite de tempo definido peloserverSelectionTimeoutMS.Diminua o serverSelectionTimeoutMS para
15000do padrão de30000. As eleições do MongoDB normalmente levam 10 segundos, mas podem ser tão rápidas quanto 5 segundos no Atlas. Definir esse valor para 15 segundos (15000milissegundos) cobre o limite superior da eleição, além do tempo adicional de latência.
Observação
Para se conectar a um cluster M0 gratuito ou a um cluster M2/M5 compartilhado no Atlas, você deve usar uma versão do driver C++ que suporte o MongoDB 4.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver C++ e o MongoDB, veja a matriz de compatibilidade do MongoDB. Recomendamos que você atualize para a versão mais recente do driver.
//... mongocxx::instance inst{}; mongocxx::client conn{mongocxx::uri{"mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority"}}; mongocxx::database db = conn["<databaseName>"];
Versão do MongoDB | Versões de driver recomendadas |
|---|---|
Todos | Consulte a matriz de compatibilidade do MongoDB para obter as versões de driver recomendadas mais recentes. |
Observação
O driver Legacy C++ alcançou o fim da vida útil e não tem mais suporte.
Comportamento
Observação
As opções de configuração a seguir só se aplicam ao usar a classe single-threaded mongocxx::client do driver C++ para se conectar ao cluster do Atlas.
Os drivers do MongoDB tentam automaticamente a seleção do servidor após uma eleição de cluster ou evento de failover. Por padrão, o driver C++ gera imediatamente um erro se a primeira tentativa de selecionar um servidor falhar. As seguintes definições de configuração podem melhorar a conectividade do aplicativo com um Atlas cluster, embora isso possa resultar em maior tempo gasto no processo de seleção do servidor:
Defina serverSelectionTryOnce como
falsepara direcionar o driver C++ a executar a seleção do servidor até o limite de tempo definido peloserverSelectionTimeoutMS.Diminua o serverSelectionTimeoutMS para
15000do padrão de30000. As eleições do MongoDB normalmente levam 10 segundos, mas podem ser tão rápidas quanto 5 segundos no Atlas. Definir esse valor para 15 segundos (15000milissegundos) cobre o limite superior da eleição, além do tempo adicional de latência.
Observação
Para se conectar a um cluster M0 gratuito ou a um cluster M2/M5 compartilhado do Atlas, você deve usar uma versão do driver C#/.Net que suporte o MongoDB 4.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver C#/.Net e o MongoDB, veja a matriz de compatibilidade do MongoDB. Recomendamos que você atualize para a versão mais recente do driver.
var client = new MongoClient("mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority"); var database = client.GetDatabase("<databaseName>");
Versão do MongoDB | Versões de driver recomendadas |
|---|---|
Todos | Consulte a matriz de compatibilidade do MongoDB para obter as versões de driver recomendadas mais recentes. |
MongoDB 5.0 e posterior | Versão 2.7 e posterior |
Observação
As versões da biblioteca do Microsoft .NET Core 2.1 e posteriores permitem a extensão SNI TLS no Linux e macOS. Os aplicativos que usam versões anteriores do .NET Core nessas plataformas não podem se conectar a um cluster gratuito do Atlas M0 ou cluster M2/M5 compartilhado.
Para saber mais sobre essa exigência, veja este problema do dotnet/corefx.
Observação
Para se conectar a um cluster M0 gratuito ou a um cluster M2/M5 compartilhado do Atlas, você deve usar uma versão do driver Go que suporte o MongoDB 4.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver Go e o MongoDB, veja a matriz de compatibilidade do MongoDB. Recomendamos que você atualize para a versão mais recente do driver.
uri := "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority" ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second) defer cancel() client, err := mongo.Connect(ctx, options.Client().ApplyURI(uri)) if err != nil { panic(err) } defer func() { if err = client.Disconnect(ctx); err != nil { panic(err) } }() // Ping the primary if err := client.Ping(ctx, readpref.Primary()); err != nil { panic(err) }
Versão do MongoDB | Versões de driver recomendadas |
|---|---|
Todos | Consulte a matriz de compatibilidade do MongoDB para obter as versões de driver recomendadas mais recentes. |
MongoDB 5.0 e posterior | Versão 1.0.0 e posterior |
Observação
Para se conectar a um cluster do Atlas M0, é necessário usar o Java versão 8 ou posterior e uma versão do driver Java compatível com o MongoDB 4.0 ou posterior. Para saber mais sobre compatibilidade entre o driver Java e o MongoDB, consulte a Matriz de compatibilidade do MongoDB.
MongoClientURI uri = new MongoClientURI( "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority"); MongoClient mongoClient = MongoClients.create(uri); MongoDatabase database = mongoClient.getDatabase("<databaseName>");
Versão do MongoDB | Versões de driver recomendadas |
|---|---|
Todos | Consulte a matriz de compatibilidade do MongoDB para obter as versões de driver recomendadas mais recentes. |
MongoDB 5.0 e posterior | Versão 3.8 e posterior |
Observação
Para se conectar a um cluster M0 gratuito ou a um cluster M2/M5 compartilhado do Atlas, você deve usar uma versão do driver Kotlin que suporte o MongoDB 4.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver Kotlin e o MongoDB, veja a matriz de compatibilidade do MongoDB. Recomendamos que você atualize para a versão mais recente do driver.
val uri = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority" // Construct a ServerApi instance using the ServerApi.builder() method val serverApi = ServerApi.builder() .version(ServerApiVersion.V1) .build() val settings = MongoClientSettings.builder() .applyConnectionString(ConnectionString(uri)) .serverApi(serverApi) .build() // Create a new client and connect to the server val mongoClient = MongoClient.create(settings) val database = mongoClient.getDatabase("<databaseName>") try { // Send a ping to confirm a successful connection val command = Document("ping", BsonInt64(1)) val commandResult = database.runCommand(command) println("Pinged your deployment. You successfully connected to MongoDB!") } catch (me: MongoException) { System.err.println(me) }
Versão do MongoDB | Versões de driver recomendadas |
|---|---|
MongoDB 5.0 e posterior | Versão 4.10 e posterior |
Observação
Para se conectar a um cluster M0 gratuito ou a um cluster M2/M5 compartilhado do Atlas, você deve usar uma versão do driver Node.js que suporte o MongoDB 4.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver Node.js e o MongoDB, veja a matriz de compatibilidade do MongoDB. Recomendamos que você atualize para a versão mais recente do driver.
import mongodb from 'mongodb'; const MongoClient = mongodb.MongoClient; const uri = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority"; const client = new MongoClient(uri, { useNewUrlParser: true }); client.connect(err => { const collection = client.db("<databaseName>").collection("<collectionName>"); // perform actions on the collection object client.close(); });
Para conectar-se a um banco de dados diferente do admin, mas ainda se autenticar no banco de dados do admin, atualize o componente database da connection string.
mongodb://username:password@host1:port1,...,hostN:portN/database?authSource=admin&...
Exemplo
A connection string a seguir especifica a implantação cluster0 e o componente de banco de dados test e inclui a opção authSource=admin.
var uriTestDb = "mongodb+srv://<db_username>:<db_password>@cluster0.mongodb.net/test?ssl=true&authSource=admin&w=majority"; MongoClient.connect(uriTestDb, function(err, db) { db.close(); });
Versão do MongoDB | Versões de driver recomendadas |
|---|---|
Todos | Consulte a matriz de compatibilidade do MongoDB para obter as versões de driver recomendadas mais recentes. |
MongoDB 5.0 e posterior | Versão 3.1 e posterior |
Observação
Para se conectar a um cluster M0 gratuito ou a um cluster M2/M5 compartilhado do Atlas, você deve usar uma versão do driver Perl que suporte o MongoDB 4.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver Perl e o MongoDB, veja a array de compatibilidade do MongoDB. Recomendamos que você atualize para a versão mais recente do driver.
my $client = MongoDB->connect('mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority'); my $db = $client->get_database( '<databaseName>' );
Versão do MongoDB | Versões de driver recomendadas |
|---|---|
MongoDB 4.2 | O MongoDB não mantém mais um driver Perl; a versão do driver 2.2.2, que suporta até MongoDB 4.2, está disponível em https://metacpan.org/pod/MongoDB |
Comportamento
Os drivers do MongoDB tentam automaticamente a seleção do servidor após uma eleição de cluster ou evento de failover. Por padrão, o driver Perl gera imediatamente um erro se a primeira tentativa de selecionar um servidor falhar. As seguintes definições de configuração podem melhorar a conectividade do aplicativo com um Atlas cluster, embora isso possa resultar em maior tempo gasto no processo de seleção do servidor:
Defina serverSelectionTryOnce como
falsepara direcionar o driver Perl a executar a seleção do servidor até o limite de tempo definido peloserverSelectionTimeoutMS.Diminua o serverSelectionTimeoutMS para
15000do padrão de30000. As eleições do MongoDB normalmente levam 10 segundos, mas podem ser tão rápidas quanto 5 segundos no Atlas. Definir esse valor para 15 segundos (15000milissegundos) cobre o limite superior da eleição, além do tempo adicional de latência.
Observação
Para se conectar a um cluster M0 gratuito ou a um cluster M2/M5 compartilhado do Atlas, você deve usar uma versão do driver PHP que suporte o MongoDB 4.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver PHP e o MongoDB, veja a array de compatibilidade do MongoDB. Recomendamos que você atualize para a versão mais recente do driver.
O exemplo a seguir usa a biblioteca PHP do MongoDB, que fornece uma abstração de alto nível em torno do driver PHP de nível inferior:
$client = new MongoDB\Client( 'mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority'); $db = $client-><databaseName>;
Versão do MongoDB | Versões de driver recomendadas |
|---|---|
Todos | Consulte a matriz de compatibilidade do MongoDB para obter as versões de driver recomendadas mais recentes. |
MongoDB 5.0 e posterior | PHPLIB 1.4 + mongodb-1.5. |
Comportamento
Os drivers do MongoDB tentam automaticamente a seleção do servidor após uma eleição de cluster ou evento de failover. Por padrão, o driver gera imediatamente um erro se a primeira tentativa de selecionar um servidor falhar. As seguintes definições de configuração podem melhorar a conectividade do aplicativo com um Atlas cluster, embora isso possa resultar em maior tempo gasto no processo de seleção do servidor:
Defina serverSelectionTryOnce como
falsepara direcionar o driver a executar a seleção do servidor até o limite de tempo definido peloserverSelectionTimeoutMS.Diminua o serverSelectionTimeoutMS para
15000do padrão de30000. As eleições do MongoDB normalmente levam 10 segundos, mas podem ser tão rápidas quanto 5 segundos no Atlas. Definir esse valor para 15 segundos (15000milissegundos) cobre o limite superior da eleição, além do tempo adicional de latência.
Observação
Para se conectar a um cluster do Atlas M0, você deve usar o Python 2.7.9 ou posterior e uma versão do driver Python compatível com o MongoDB 4.0 ou posterior. Para saber mais sobre compatibilidade entre o driver Python e o MongoDB, consulte a matriz de compatibilidade do MongoDB.
import pymongo import dns # required for connecting with SRV client = pymongo.MongoClient("mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority") db = client.<databaseName>
Versão do MongoDB | Versões de driver recomendadas |
|---|---|
Todos | Consulte a matriz de compatibilidade do MongoDB para obter as versões de driver recomendadas mais recentes. |
MongoDB 5.0 e posterior | Versão 3.7 e posterior |
Observação
macOS e Python 3.6 Instaladores
Os instaladores 3.6 do Python para macOS em https://www.python.org não instalam automaticamente nenhum certificado de CA. Sem certificados de CA instalado, as conexões com o Atlas falharão na verificação de certificados.
Depois de executar o instalador de https://www.python.org para instalar o Python 3.6, você deve executar o seguinte script para instalar um pacote de CA atualizado antes de se conectar ao Atlas:
open "/Applications/Python 3.6/Install Certificates.command"
Para obter mais informações sobre 3.6 instaladores Python para macOS em https://www.python.org, veja https://bugs.python.org/issue29065#msg283984. Versões anteriores do Python, bem como Python 3.6 instalado por outros meios (por exemplo Homebrew), não são afetados.
Observação
Para se conectar a um cluster gratuito do Atlas M0 ou a um cluster compartilhado M2/M5, você deve usar uma versão do driver Ruby que suporte o MongoDB 4.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver Ruby e o MongoDB, veja a matriz de compatibilidade do MongoDB. Recomendamos que você atualize para a versão mais recente do driver.
client = Mongo::Client.new('mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority')
Para conectar-se a um banco de dados diferente do admin, mas ainda se autenticar no banco de dados do admin, atualize o componente database da connection string.
mongodb://username:password@host1:port1,...,hostN:portN/database?authSource=admin&...
Exemplo
A string de conexão a seguir especifica a implantação cluster0 e o componente de banco de dados test e inclui a opção authSource=admin.
client = Mongo::Client.new('mongodb+srv://<db_username>:<db_password>@cluster0.mongodb.net/test?ssl=true&replicaSet=Mycluster0-shard-0&authSource=admin&w=majority')
Versão do MongoDB | Versões de driver recomendadas |
|---|---|
Todos | Consulte a matriz de compatibilidade do MongoDB para obter as versões de driver recomendadas mais recentes. |
MongoDB 5.0 e posterior | Versão 2.6 e posterior |
Exemplo do Mongoid
production: # Configure available database clients. (required) clients: # Defines the default client. (required) default: # Defines the name of the default database that Mongoid can connect to. # (required). database: 'myDatabaseName' # Provides the hosts the default client can connect to. Must be an array # of host:port pairs. (required) hosts: - mycluster0-shard-00-00.mongodb.net:27017 - mycluster0-shard-00-01.mongodb.net:27017 - mycluster0-shard-00-02.mongodb.net:27017 options: # The name of the user for authentication. user: <username> # The password of the user for authentication. password: <password> # The database or source to authenticate the user against. If the database # specified above is not admin, admin MUST be specified here. auth_source: admin # All Atlas servers use SSL. (default: false) ssl: true
Versão do MongoDB | Versão mínima do ODM |
|---|---|
MongoDB 5.0 e posterior |
O tempo de execução assíncrono padrão usado pelo driver é tokio. Para usar um tempo de execução diferente, consulte Configurar o tempo de execução assíncrono.
Observação
Para se conectar a um cluster gratuito do Atlas M0 ou cluster M2/M5 compartilhado, você deve usar uma versão do driver Rust que suporte o MongoDB 4.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver Rust e o MongoDB, veja a matriz de compatibilidade do MongoDB. Recomendamos que você atualize para a versão mais recente do driver.
use mongodb::{options::ClientOptions, Client}; async fn main() -> mongodb::error::Result<()> { let client_options = ClientOptions::parse( "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority", ) .await?; let client = Client::with_options(client_options)?; let _database = client.database("<databaseName>"); // List the names of the databases in that cluster for db_name in client.list_database_names(None, None)? { println!("{}", db_name); } Ok(()) }
Versão do MongoDB | Versões de driver recomendadas |
|---|---|
Todos | Consulte a matriz de compatibilidade do MongoDB para obter as versões de driver recomendadas mais recentes. |
Certifique-se de ter habilitado a API de sincronização. Consulte Habilitar a API de sincronização para mais detalhes.
Observação
Para se conectar a um cluster gratuito do Atlas M0 ou cluster M2/M5 compartilhado, você deve usar uma versão do driver Rust que suporte o MongoDB 4.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver Rust e o MongoDB, veja a matriz de compatibilidade do MongoDB. Recomendamos que você atualize para a versão mais recente do driver.
use mongodb::{bson::doc, sync::Client}; fn main() -> mongodb::error::Result<()> { let client_options = ClientOptions::parse( "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority", )?; // Ping the server to see if you can connect to the cluster client .database("admin") .run_command(doc! {"ping": 1}, None)?; println!("Connected successfully."); // List the names of the databases in that cluster for db_name in client.list_database_names(None, None)? { println!("{}", db_name); } Ok(()) }
Versão do MongoDB | Versões de driver recomendadas |
|---|---|
Todos | Consulte a matriz de compatibilidade do MongoDB para obter as versões de driver recomendadas mais recentes. |
Observação
Para se conectar a um cluster M0 gratuito ou a um cluster M2/M5 compartilhado do Atlas, você deve usar uma versão do driver Scala que suporte o MongoDB 4.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver Scala e o MongoDB, veja a array de compatibilidade do MongoDB. Recomendamos que você atualize para a versão mais recente do driver.
val uri: String = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority" System.setProperty("org.mongodb.async.type", "netty") val client: MongoClient = MongoClient(uri) val db: MongoDatabase = client.getDatabase("<databaseName>")
Versão do MongoDB | Versões de driver recomendadas |
|---|---|
Todos | Consulte a matriz de compatibilidade do MongoDB para obter as versões de driver recomendadas mais recentes. |
Observação
Para se conectar a um cluster M0 gratuito ou a um cluster M2/M5 compartilhado do Atlas, você deve usar uma versão do driver Swift que suporte o MongoDB 4.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver Swift e o MongoDB, veja a array de compatibilidade do MongoDB. Recomendamos que você atualize para a versão mais recente do driver.
import MongoSwift import NIO let elg = MultiThreadedEventLoopGroup(numberOfThreads: 4) let uri = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority" let client = try MongoClient( uri, using: elg ) defer { // clean up driver resources try? client.syncClose() cleanupMongoSwift() // shut down EventLoopGroup try? elg.syncShutdownGracefully() } // print a list of database names to confirm connection print(try client.listDatabaseNames().wait())
Versão do MongoDB | Versões de driver recomendadas |
|---|---|
Todos | Consulte a matriz de compatibilidade do MongoDB para obter as versões de driver recomendadas mais recentes. |
Observação
Para se conectar a um cluster M0 gratuito ou a um cluster M2/M5 compartilhado do Atlas, você deve usar uma versão do driver Swift que suporte o MongoDB 4.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver Swift e o MongoDB, veja a array de compatibilidade do MongoDB. Recomendamos que você atualize para a versão mais recente do driver.
import MongoSwiftSync let uri = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority" let client = try MongoClient(uri) // print a list of database names to confirm connection print (try client.listDatabaseNames())
Versão do MongoDB | Versões de driver recomendadas |
|---|---|
Todos | Consulte a matriz de compatibilidade do MongoDB para obter as versões de driver recomendadas mais recentes. |
Solução de problemas
Se você estiver enfrentando problemas para se conectar ao seu cluster, consulte Solucionar problemas de conexão.