Guia de conexão

URI de conexão

O URI de conexão é o conjunto de instruções que o driver utiliza para se conectar a um sistema MongoDB. Ele instrui o driver sobre como deve se conectar ao MongoDB e como deve se comportar enquanto estiver conectado. O exemplo a seguir mostra cada parte do URI de conexão:

Neste exemplo, conectamos a uma implantação do Atlas MongoDB que tem um registro DNS SRV. Para obter mais detalhes, consulte a documentação do formato de conexão da lista de sementes de DNS. Este formato oferece flexibilidade na implantação e a capacidade de alterar os servidores em rotação sem reconfigurar os clientes.

Se você estiver se conectando a uma instância ou definir de réplicas que não tenha um endereço DNS SRV, deverá usar mongodb para o protocolo, que especifica o formato de string de conexão padrão.

Após o protocolo, a próxima parte da connection string contém as credenciais se você estiver usando a autenticação baseada em senha. Substitua o valor de user pelo seu nome de usuário e pass pela sua senha. Se você estiver usando um mecanismo de autenticação que não requer um nome de usuário e senha, omita esta parte do URI de conexão.

A próxima parte da connection string especifica o nome do host ou endereço IP da sua instância MongoDB, seguido pelo número da porta. No exemplo acima, usamos sample.host como o nome do host e 27017 como a porta. Substitua estes valores para apontar para a sua instância MongoDB.

A última parte da connection string contém opções de conexão e autenticação como parâmetros. No exemplo acima, definimos duas opções de conexão: maxPoolSize=20 e w=majority. Para obter mais informações sobre opções de conexão, vá para a seção Opções de Conexão.

Exemplo de conexão do Atlas

Você deve criar um cliente para se conectar a um sistema MongoDB no Atlas. Para criar um cliente, crie uma instância do MongoClient, passando em seu URI e um objeto MongoClientOptions.

Use a opção serverApi no seu objeto MongoClientOptions para habilitar a funcionalidade de API Estável, que força o servidor a executar operações com comportamento compatível com a versão de API especificada.

O código a seguir mostra como você pode especificar a cadeia de conexão e a opção de cliente Stable API ao se conectar a uma implementação do MongoDB no Atlas e verificar se a conexão foi bem-sucedida:

const { MongoClient, ServerApiVersion } = require("mongodb");
// Replace the placeholder with your Atlas connection string
const uri = "<connection string>";
// Create a MongoClient with a MongoClientOptions object to set the Stable API version
const client = new MongoClient(uri,  {
        serverApi: {
            version: ServerApiVersion.v1,
            strict: true,
            deprecationErrors: true,
        }
    }
);
async function run() {
  try {
    // Connect the client to the server (optional starting in v4.7)
    await client.connect();
    // Send a ping to confirm a successful connection
    await client.db("admin").command({ ping: 1 });
    console.log("Pinged your deployment. You successfully connected to MongoDB!");
  } finally {
    // Ensures that the client will close when you finish/error
    await client.close();
  }
}
run().catch(console.dir);

Para saber mais sobre o recurso de API estável, consulte a página de API estável.

Outras maneiras de se conectar ao MongoDB

Se estiver se conectando a uma única instância ou conjunto de réplicas do servidor MongoDB que não esteja hospedado no Atlas, consulte as seções a seguir para saber como se conectar.

mongodb://localhost:<port>

mongodb://host1:27017,host2:27017,host3:27017/?replicaSet=myRs