/ /

Conexão do Atlas cluster

Página inicial do Docs

Desenvolvimento

Conectar-se a um cluster

Conexão do Atlas cluster

Página inicial do Docs

Desenvolvimento

Conectar-se a um cluster

Conexão do Atlas cluster

Conectar-se a um cluster por meio de bibliotecas de clientes

A caixa de diálogo Connect para um cluster fornece os detalhes para se conectar a um cluster com um aplicativo usando uma biblioteca de cliente do MongoDB.

➤ 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 tabela de compatibilidade da biblioteca do cliente para seu driver.

Importante

Driver oficialmente suportado

Use officially supported MongoDB drivers at current versions for the best reliability and support experience. The Atlas SLA covers officially supported drivers only.

O Atlas oferece suporte de melhor esforço e apenas para diagnóstico para drivers da Community e versões de driver de fim de vida. O Atlas não testa, corrige ou certifica drivers da Community. O suporte ajuda a determinar se os problemas de conexão se originam da plataforma ou do driver, mas não depura o código do driver.

Para aprender mais, consulte Qual é a política de suporte do Atlas para drivers da Community e não suportados?.

Cadeias de conexão otimizadas para clusters fragmentados atrás de um private endpoint

Você pode se conectar ao seu cluster fragmentado usando um driver e uma string de conexão otimizada.

TLS

Os clientes devem oferecer suporte a TLS para se conectar a um cluster do Atlas.

Clients must support the SNI TLS extension to connect to an Atlas Free cluster (formerly known as M0) or Flex cluster.

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

To access a cluster, you must have a database user with access to the desired databases on your Atlas cluster. Database users are separate from Atlas users. Database users have access to MongoDB databases, while Atlas users have access to the Atlas application itself.

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 os usuários de banco de dados a partir da visualização cluster. O Atlas cria um usuário de banco de dados quando você cria seu primeiro cluster.

Conectar seu aplicativo

No Atlas, vá para a página Clusters 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.
Na barra lateral, clique em Clusters sob o título Database.

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 o AWS e está se conectando ao 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 dos seus pares esteja marcado como AVAILABLE. Para saber como verificar o status de seus pares, consulte Visualizar conexões de peering de rede Atlas.

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.

With multi-cloud clusters, consider adding the readPreference connection option to your connection string. Use one of the following values:

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.

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 o seu projeto não tiver usuários do MongoDB, o Atlas solicitará a criação de um novo usuário com a função Admin do Atlas.

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 de banco de dados.

Em Use this connection string in your application, a string de conexão usa o formato SRV (mongodb+srv://) por padrão. Para visualizar a string de conexão padrão (não-SRV) (mongodb://), desative a alternância SRV Connection String.

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

In the following example, you authenticate and connect to an Atlas cluster by using a URI connection string. Replace the placeholders in the example with your credentials and deployment details.

Observação

Para se conectar a um cluster do Atlas M0 gratuito ou a um cluster flexível, você deve usar uma versão do driver C que tenha suporte para o MongoDB 7.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver C e o MongoDB, consulte a matriz 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	See the MongoDB compatibility matrix for the latest recommended driver versions.
MongoDB 7.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:

Set serverSelectionTryOnce to false to direct the C driver to perform server selection up to the time limit defined by serverSelectionTimeoutMS.
Lower the serverSelectionTimeoutMS to 15000 from the default of 30000. MongoDB elections typically take 10 seconds, but can be as fast as 5 seconds on Atlas. Setting this value to 15 seconds (15000 milliseconds) covers the upper bound of election plus additional time for latency.

Observação

To connect to an Atlas M0 Free cluster or a Flex cluster, you must use a C++ driver version that supports MongoDB 7.0 and later. For complete documentation on compatibility between the C++ driver and MongoDB, see the MongoDB compatibility matrix. We recommend that you upgrade to the latest version of the 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	See the MongoDB compatibility matrix for the latest recommended driver versions.

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:

Set serverSelectionTryOnce to false to direct the C++ driver to perform server selection up to the time limit defined by serverSelectionTimeoutMS.
Lower the serverSelectionTimeoutMS to 15000 from the default of 30000. MongoDB elections typically take 10 seconds, but can be as fast as 5 seconds on Atlas. Setting this value to 15 seconds (15000 milliseconds) covers the upper bound of election plus additional time for latency.

Observação

To connect to an Atlas M0 Free cluster or a Flex cluster, you must use a C#/.Net driver version that supports MongoDB 7.0 and later. For complete documentation on compatibility between the C#/.Net driver and MongoDB, see the MongoDB compatibility matrix. We recommend that you upgrade to the latest version of the 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	See the MongoDB compatibility matrix for the latest recommended driver versions.
MongoDB 7.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 Atlas Free ou Flex cluster.

Para saber mais sobre essa exigência, veja este problema do dotnet/corefx.

Observação

Para se conectar a um cluster do Atlas M0 gratuito ou a um cluster flexível, você deve usar uma versão do driver Go que tenha suporte para o MongoDB 7.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver Go e o MongoDB, consulte 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"
clientOpts := options.Client().ApplyURI(uri).SetTimeout(10 * time.Second)
client, err := mongo.Connect(clientOpts)
if err != nil {
   log.Fatalf("Failed to connect to MongoDB: %v", err)
}
defer func() {
   if err = client.Disconnect(); err != nil {
      log.Fatalf("Failed to disconnect from MongoDB: %v", err)
   }
}()
ctx := context.Background()
// Ping the primary
if err := client.Ping(ctx, readpref.Primary()); err != nil {
   log.Fatalf("Failed to ping MongoDB: %v", err)
}

Versão do MongoDB	Versões de driver recomendadas
Todos	See the MongoDB compatibility matrix for the latest recommended driver versions.
MongoDB 7.0 e posterior	Versão 1.0.0 e posterior

Observação

Para se conectar a um cluster do Atlas M0 ou a um cluster flexível, você deve usar a versão 8 do Java ou posterior e usar uma versão do driver Java que tenha suporte para o MongoDB 7.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	See the MongoDB compatibility matrix for the latest recommended driver versions.
MongoDB 7.0 e posterior	Versão 3.8 e posterior

Observação

Para se conectar a um cluster do Atlas M0 gratuito ou a um cluster flexível, você deve usar uma versão do driver Kotlin que tenha suporte para o MongoDB 7.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver Kotlin e o MongoDB, consulte 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 7.0 e posterior	Versão 4.10 e posterior

Observação

Para se conectar a um cluster do Atlas M0 gratuito ou a um cluster flexível, você deve usar uma versão do driver Node.js que tenha suporte para o MongoDB 7.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver Node.js e o MongoDB, consulte 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);
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	See the MongoDB compatibility matrix for the latest recommended driver versions.
MongoDB 7.0 e posterior	Versão 3.1 e posterior

Observação

To connect to an Atlas M0 Free cluster or a Flex cluster, you must use a PHP driver version that supports MongoDB 7.0 and later. For complete documentation on compatibility between the PHP driver and MongoDB, see the MongoDB compatibility matrix. We recommend that you upgrade to the latest version of the 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	See the MongoDB compatibility matrix for the latest recommended driver versions.
MongoDB 7.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:

Set serverSelectionTryOnce to false to direct the driver to perform server selection up to the time limit defined by serverSelectionTimeoutMS.
Lower the serverSelectionTimeoutMS to 15000 from the default of 30000. MongoDB elections typically take 10 seconds, but can be as fast as 5 seconds on Atlas. Setting this value to 15 seconds (15000 milliseconds) covers the upper bound of election plus additional time for latency.

Observação

Para se conectar a um cluster do Atlas M0 ou a um cluster flexível, você deve usar Python 2.7.9 ou posterior e usar uma versão do driver Python que tenha suporte para o MongoDB 7.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	See the MongoDB compatibility matrix for the latest recommended driver versions.
MongoDB 7.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 instaladores do Python 3.6 para macOS em https://www.python.org, consulte https://bugs.python.org/issue29065#msg283984. Versões anteriores do Python, bem como Python 3.6 instalados por outros meios (por exemplo Homebrew), não são afetados.

Observação

Para se conectar a um cluster do Atlas M0 gratuito ou a um cluster flexível, você deve usar uma versão do driver Ruby que tenha suporte para o MongoDB 7.0 e posterior. Para documentação completa sobre a compatibilidade entre o driver Ruby e o MongoDB, consulte 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	See the MongoDB compatibility matrix for the latest recommended driver versions.
MongoDB 7.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 7.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

To connect to an Atlas M0 Free cluster or a Flex cluster, you must use a Rust driver version that supports MongoDB 7.0 and later. For complete documentation on compatibility between the Rust driver and MongoDB, see the MongoDB compatibility matrix. We recommend that you upgrade to the latest version of the 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	See the MongoDB compatibility matrix for the latest recommended driver versions.

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	See the MongoDB compatibility matrix for the latest recommended driver versions.

Observação

To connect to an Atlas M0 Free cluster or a Flex cluster, you must use a Scala driver version that supports MongoDB 7.0 and later. For complete documentation on compatibility between the Scala driver and MongoDB, see the MongoDB compatibility matrix. We recommend that you upgrade to the latest version of the 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	See the MongoDB compatibility matrix for the latest recommended driver versions.

Observação

To connect to an Atlas M0 Free cluster or a Flex cluster, you must use a Swift driver version that supports MongoDB 7.0 and later. For complete documentation on compatibility between the Swift driver and MongoDB, see the MongoDB compatibility matrix. We recommend that you upgrade to the latest version of the 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	See the MongoDB compatibility matrix for the latest recommended driver versions.

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	See the MongoDB compatibility matrix for the latest recommended driver versions.

Solução de problemas

Se você estiver enfrentando problemas para se conectar ao seu cluster, consulte Solucionar problemas de conexão.

Dica

Limites de conexão e camada do cluster

Voltar

Conexão do Atlas cluster

Compass