Conexão via Drivers

Nesta página

Pré-requisitos

Conectar seu aplicativo
Exemplos de driver
Solução de problemas

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:

Driver	Versão
C	1.19.0
C++	3.7.0beta1
C#	2.13.0
Go	1.6.0
Java	4.3.0
Kotlin	4.10.0
Motor	2.5.0
Node.js	4.1.0
PHP	1.11.0 (Extension) 1.10.0 (Library)
PyMongo	3.12.0
Ruby	2.16.0
Rust	2.1.0
Scala	4.3.0
Swift	1.2.0

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.

Clique em Connect.

Clique em Connect para o cluster 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.

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.

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

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 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 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 false para direcionar o driver C a executar a seleção do servidor até o limite de tempo definido pelo serverSelectionTimeoutMS.
Diminua o serverSelectionTimeoutMS para 15000 do padrão de 30000. 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 (15000 milissegundos) 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.

#include <mongocxx/client.hpp>
#include <mongocxx/instance.hpp>
//...
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 false para direcionar o driver C++ a executar a seleção do servidor até o limite de tempo definido pelo serverSelectionTimeoutMS.
Diminua o serverSelectionTimeoutMS para 15000 do padrão de 30000. 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 (15000 milissegundos) 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 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 false para direcionar o driver a executar a seleção do servidor até o limite de tempo definido pelo serverSelectionTimeoutMS.
Diminua o serverSelectionTimeoutMS para 15000 do padrão de 30000. 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 (15000 milissegundos) 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	Versão 7.0.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};
#[tokio::main]
    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

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

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.

Dica

Veja também:

Limites de conexão e camada do cluster

Voltar

Métodos de conexão

Compass