Conectarse a un clúster a través de bibliotecas de cliente

El Connect El cuadro de diálogo para un clúster proporciona los detalles para conectarse a un clúster con una aplicación mediante un Biblioteca cliente MongoDB.

➤ Utilice el menú desplegable Seleccione su lenguaje para establecer el idioma del ejemplo en esta página.

Requisitos previos

Versión del controlador

La versión de su driver debe ser compatible con su versión del servidor de MongoDB. Le recomendamos que elija el driver más reciente que sea compatible con la versión de su servidor MongoDB para utilizar las características más recientes de la base de datos y prepararse para futuras actualizaciones de la versión.

Para obtener una lista de versiones de drivers que contienen el conjunto completo de funcionalidades para su versión del servidor de MongoDB, consulte la matriz de compatibilidad para su driver de MongoDB.

Cadenas de conexión optimizadas para clústeres fragmentados detrás de un nodo privado

Puede conectarse a su clúster fragmentado mediante un controlador y un cadena de conexión optimizada.

TLS

Los clientes deben admitir TLS para conectarse a un clúster de Atlas.

Los clientes deben apoyar el SNIExtensión TLS para conectarse a un Atlas M0 Clúster libre o clúster flexible.

Lista de acceso IP

Para acceder a un clúster, debes conectarte desde una dirección IP que esté en la lista de acceso IP del proyecto de Atlas. Si necesitas añadir una dirección IP a la lista de acceso IP, puedes hacerlo en el cuadro de diálogo Connect. También puedes agregar la dirección IP desde la pestaña Acceso a la red.

Usuario de base de datos

Para acceder a un clúster, debe crearse un usuario de base de datos con acceso a las bases de datos deseadas en el clúster de Atlas. Los usuarios de base de datos son distintos de los usuarios de Atlas. Los usuarios de bases de datos tienen acceso a las bases de datos de MongoDB, mientras que los usuarios de Atlas tienen acceso a la aplicación Atlas en sí.

Es posible crear un usuario de base de datos para acceder al clúster de Atlas en el cuadro de diálogo Connect. También se puede añadir el usuario de base de datos desde la vista del clúster.

Conecte su aplicación

En Atlas, ve a la página Clusters de tu proyecto.

Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Clusters en la sección Database.

La página de clústeres se muestra.

Haga clic en Connect.

Haz clic en Connect para el clúster al que deseas conectarte.

Elija la seguridad de su conexión.

Choose Connection Type del conjunto de botones disponibles.

Nota

Mostrar opciones si la característica está activada

Atlas muestra las opciones de tipo de conexión después de habilitar IP privada para emparejamiento, nodos privados, o ambos. Si no has habilitado ninguna de las dos características, no se mostrarán botones y Connection Type se establecerá por defecto en Standard.

Utilice este tipo de conexión para las direcciones IP públicas autorizadas.

Utilizar este tipo de conexión si se ha habilitado el emparejamiento:

Para Google Cloud o Azure, y si se está conectando con su driver desde una red de emparejamiento, o
Para AWS, y si se está conectando con su driver desde una red de emparejamiento que utiliza un servicio DNS personalizado.

Si ninguno de estos se aplica, agregue su dirección IP a su lista de acceso IP y utilice la cadena de conexión estándar. Si se conecta directamente a Atlas desde una oficina o una red doméstica, esta podría ser la opción de preferencia.

Nota

El emparejamiento debe estar disponible

No se puede seleccionar esta opción a menos que uno de los pares esté marcado como AVAILABLE. Para aprender cómo verificar el estado de los pares, consulta Ver conexiones peering de red de Atlas.

Nota

Clústeres multicloud

Si la aplicación no está alojada en el mismo proveedor de servicios de nube que el primario del clúster, la aplicación solo puede realizar lecturas secundarias.

Con clústeres multi-nube, se debe considerar agregar la opción de conexión readPreference a la cadena de conexión. Se deben usar uno de los siguientes valores:

Se debe usar la cadena de conexión para el endpoint de la interfaz apropiado si se realiza la conexión con el driver a través de una conexión de nodos privados, ya sea porque el driver:

Se ejecuta dentro de la red de su proveedor de nube, o
Tiene acceso transitivo a la red del proveedor de nube.
Debe usarse una cadena de conexión optimizada.

Si ninguno de estos se aplica, se debe agregar la dirección IP a la lista de acceso IP y usar la cadena de conexión estándar. Si se realiza la conexión directamente a Atlas desde una oficina o una red doméstica, esta podría ser la opción preferida.

Nota

No puede seleccionar esta opción a menos que su conexión PrivateLink configurada esté lista para usar. Para aprender cómo verificar el estado de su AWS PrivateLink, consulte Solucionar problemas de conexión de nodos privados.

Elija cómo desea limitar las conexiones a tu clúster.

Add a Connection IP Address

Importante

Omite este paso si Atlas indica en el paso Setup connection security que ya se ha configurado una entrada de la lista de acceso IP en el clúster. Para gestionar la lista de acceso IP, se debe consultar Agregar entradas a la lista de acceso.

Atlas permite conexiones estándar de clientes al clúster desde las entradas de la lista de acceso IP del proyecto. La lista de acceso IP del proyecto difiere de la lista de acceso a la API, que restringe el acceso a la API a direcciones IP o CIDR específicas.

Si la lista de acceso IP está vacía, Atlas le solicita añadir una dirección IP a la lista de acceso IP del proyecto. Puede hacerse:

Se debe hacer clic en Add Your Current IP Address para permitir el acceso desde tu dirección IP actual.
Haz clic en Add an IP Address para agregar una sola dirección IP o un rango de direcciones con notación CIDR.

Ingresa una descripción opcional para la dirección IP recién agregada o el rango CIDR. Haz clic en Add IP Address para agregar la dirección a la lista de acceso IP.

Add a Connection IP Address

Importante

Omita este paso si Atlas indica en el paso Setup connection security que ya ha configurado una entrada de la lista de acceso IP en su clúster. Para gestionar la lista de acceso IP, consulte Agregar entradas a la lista de acceso IP.

Si la lista de acceso IP está vacía, Atlas solicitará agregar una dirección IP a la lista de acceso IP del proyecto. Haz clic en Add a Different IP Address para agregar una sola dirección IP o un rango de direcciones con notación CIDR.

Ingresa una descripción opcional para la dirección IP recién agregada o el rango CIDR. Haz clic en Add IP Address para agregar la dirección a la lista de acceso IP.

En Choose Connection Type, selecciona Private Endpoint.
Si se ven las opciones Private Link Type, seleccionar una de las siguientes opciones:
- Optimized SRV Connection para conexiones equilibradas.
- Legacy SRV Connection para conexiones no balanceadas.
Para obtener más información, consulta ¿Cómo puedo optimizar el rendimiento de la conexión para clústeres particionados mediante nodos privados?.
En Choose Private Endpoint, selecciona el endpoint que desea usar.

Cree un usuario de base de datos.

Importante

Omita este paso si Atlas indica en el paso Setup connection security que tiene al menos un usuario de base de datos configurado en su proyecto. Para gestionar los usuarios de base de datos existentes, consulte Configurar usuarios de base de datos.

Para acceder al clúster, necesita un usuario de MongoDB con acceso a la base de datos deseada en el clúster de su proyecto. Si su proyecto no tiene usuarios de MongoDB, Atlas le solicitará que cree un nuevo usuario con el rol de administrador de Atlas.

Introducir el Username del nuevo usuario.
Introduzca un Password para este nuevo usuario o haga clic en Autogenerate Secure Password.
Hacer clic en Create Database User para guardar al usuario.

Se debe usar este usuario para realizar la conexión al clúster en el siguiente paso.

Una vez que se haya añadido una dirección IP a la lista de acceso IP y un usuario de base de datos, se debe hacer clic en Choose Your Connection Method.

Seleccione Drivers.

En el paso Choose a connection method, seleccione Drivers.

Seleccione su controlador y versión.

Seleccione su driver y la versión de los menús desplegables. Aparece la muestra del código que contiene una cadena de conexión. Sustituya <password> por la contraseña especificada cuando creó su usuario de base de datos.

Nota

Si sus contraseñas, nombres de bases de datos o cadenas de conexión contienen caracteres URI reservados, debe reemplazar dichos caracteres. Por ejemplo, si su contraseña es @bc123, debe reemplazar el carácter @ al especificar la contraseña en la cadena de conexión, como %40bc123. Para obtener más información, consulte los Caracteres especiales en la contraseña de la cadena de conexión.

Para aprender más, consulte Compatibilidad de drivers.

Ejemplos de driver

En el siguiente ejemplo, se realiza la autenticación y la conexión a un clúster de Atlas utilizando una cadena de conexión URI. Se deben reemplazar los marcadores de posición en el ejemplo con las credenciales y los detalles de implementación.

Nota

Para realizar la conexión a un clúster Atlas M0 gratuito o a un clúster Flex, se debe usar una versión del driver C que sea compatible con MongoDB 7.0 y versiones posteriores. Para obtener la documentación completa sobre la compatibilidad entre el driver C y MongoDB, se debe consultar la matriz de compatibilidad de MongoDB. Recomendamos actualizar a la versión más reciente del 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>");

Versión de MongoDB	Versiones recomendadas de controladores
Todo	Consulte la matriz de compatibilidad de MongoDB para las últimas versiones recomendadas de controladores.
MongoDB 7.0 y versiones posteriores	Versión 1.11 o posterior

Comportamiento

Nota

Las siguientes opciones de configuración solo se aplican si se ejecuta el driver C en modo de un solo hilo.

Los controladores de MongoDB intentan automáticamente la selección del servidor tras un evento de elección de clúster o conmutación por error. Por defecto, el controlador C genera inmediatamente un error si su primer intento de seleccionar un servidor falla. Los siguientes ajustes de configuración pueden mejorar la conectividad de una aplicación a un clúster de Atlas a costa de pasar más tiempo en un bucle de selección de servidor:

Configura serverSelectionTryOnce en false para dirigir al controlador C a realizar la selección del servidor hasta el límite de tiempo definido por serverSelectionTimeoutMS.
Reduzca el serverSelectionTimeoutMS a 15000 desde el valor por defecto de 30000. Las elecciones de MongoDB suelen tardar 10 segundos, pero pueden ser tan rápidas como 5 segundos en Atlas. Configurar este valor en 15 segundos (15000 milisegundos) cubre el límite superior de la elección más tiempo adicional para la latencia.

Nota

Para realizar la conexión a un clúster Atlas M0 gratuito o un clúster Flex, se debe usar una versión del driver C++ que sea compatible con MongoDB 7.0 y versiones posteriores. Para obtener la documentación completa sobre la compatibilidad entre el driver C++ y MongoDB, se debe consultar la matriz de compatibilidad de MongoDB. Recomendamos actualizar a la versión más reciente del 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>"];

Versión de MongoDB	Versiones recomendadas de controladores
Todo	Consulte la matriz de compatibilidad de MongoDB para las últimas versiones recomendadas de controladores.

Nota

El driver C++ heredado ha llegado al final de su vida útil y ya no cuenta con soporte.

Comportamiento

Nota

Las siguientes opciones de configuración solo se aplican cuando se utiliza la clase de driver de un solo hilo mongocxx::client C++ para conectarse al clúster Atlas.

Los controladores de MongoDB intentan automáticamente la selección del servidor tras un evento de elección de clúster o conmutación por error. Por defecto, el controlador C++ genera inmediatamente un error si su primer intento de seleccionar un servidor falla. Los siguientes ajustes de configuración pueden mejorar la conectividad de una aplicación a un clúster de Atlas a costa de pasar más tiempo en un bucle de selección de servidor:

Configure serverSelectionTryOnce a false para dirigir al driver C++ a realizar la selección del servidor hasta el límite de tiempo definido por serverSelectionTimeoutMS.
Reduzca el serverSelectionTimeoutMS a 15000 desde el valor por defecto de 30000. Las elecciones de MongoDB suelen tardar 10 segundos, pero pueden ser tan rápidas como 5 segundos en Atlas. Configurar este valor en 15 segundos (15000 milisegundos) cubre el límite superior de la elección más tiempo adicional para la latencia.

Nota

Para realizar la conexión a un clúster Atlas M0 gratuito o a un clúster Flex, se debe usar una versión del driver C#/.Net que sea compatible con MongoDB 7.0 y versiones posteriores. Para obtener la documentación completa sobre la compatibilidad entre el driver C#/.Net y MongoDB, se debe consultar la matriz de compatibilidad de MongoDB. Recomendamos actualizar a la versión más reciente del driver.

var client = new MongoClient("mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority");
var database = client.GetDatabase("<databaseName>");

Versión de MongoDB	Versiones recomendadas de controladores
Todo	Consulte la matriz de compatibilidad de MongoDB para las últimas versiones recomendadas de controladores.
MongoDB 7.0 y versiones posteriores	Versión 2.7 o posterior

Nota

Las versiones 2.1 y posteriores de la biblioteca de Microsoft.NET Core admiten la extensión SNI TLS en Linux y macOS. Las aplicaciones que usan versiones anteriores de .NET Core en estas plataformas no pueden conectarse a un M0 clúster gratuito o flexible de Atlas.

Para aprender más sobre este requisito, consulte este tema dotnet/corefx.

Nota

Para realizar la conexión a un clúster Atlas M0 gratuito o a un clúster Flex, se debe usar una versión del driver de Go que soporte MongoDB 7.0 y versiones posteriores. Para obtener la documentación completa sobre la compatibilidad entre el driver de Go y MongoDB, se debe consultar la matriz de compatibilidad de MongoDB. Recomendamos actualizar a la versión más reciente del 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)
}

Versión de MongoDB	Versiones recomendadas de controladores
Todo	Consulte la matriz de compatibilidad de MongoDB para las últimas versiones recomendadas de controladores.
MongoDB 7.0 y versiones posteriores	Versión 1.0.0 y posteriores

Nota

Para conectarte a un clúster de Atlas M0 o a un clúster de Flex, debes utilizar la versión de Java 8 o posterior y una versión del driver de Java que sea compatible con MongoDB 7.0 o posterior. Para obtener más información sobre la compatibilidad entre el driver de Java y MongoDB, consulta la matriz de compatibilidad de 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>");

Versión de MongoDB	Versiones recomendadas de controladores
Todo	Consulte la matriz de compatibilidad de MongoDB para las últimas versiones recomendadas de controladores.
MongoDB 7.0 y versiones posteriores	Versión 3.8 o posterior

Nota

Para realizar la conexión a un clúster de Atlas M0 gratuito o un clúster Flex, se debe usar una versión del driver de Kotlin que sea compatible con MongoDB 7.0 y versiones posteriores. Para obtener la documentación completa sobre la compatibilidad entre el driver de Kotlin y MongoDB, se debe consultar la matriz de compatibilidad de MongoDB. Recomendamos actualizar a la versión más reciente del 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)
}

Versión de MongoDB	Versiones recomendadas de controladores
MongoDB 7.0 y versiones posteriores	Versión 4.10 o posterior

Nota

Para realizar la conexión a un clúster de Atlas M0 gratuito o a un clúster Flex, se debe usar una versión del driver de Nodo.js que sea compatible con MongoDB 7.0 y versiones posteriores. Para obtener la documentación completa sobre la compatibilidad entre el driver de Nodo.js y MongoDB, se debe consultar la matriz de compatibilidad de MongoDB. Recomendamos actualizar a la versión más reciente del 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 conectarte a una base de datos distinta de admin pero aún autenticarte en la base de datos admin, actualiza el componente database de la cadena de conexión.

mongodb://username:password@host1:port1,...,hostN:portN/database?authSource=admin&...

Ejemplo

La siguiente cadena de conexión especifica la implementación cluster0 y el componente de base de datos test, e incluye la opción 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();
});

Versión de MongoDB	Versiones recomendadas de controladores
Todo	Consulte la matriz de compatibilidad de MongoDB para las últimas versiones recomendadas de controladores.
MongoDB 7.0 y versiones posteriores	Versión 3.1 o posterior

Nota

Para realizar la conexión a un clúster de Atlas M0 gratuito o a un clúster de Flex, se debe usar una versión del driver de PHP que soporte MongoDB 7.0 y versiones posteriores. Para obtener la documentación completa sobre la compatibilidad entre el driver PHP y MongoDB, se debe consultar la matriz de compatibilidad de MongoDB. Recomendamos actualizar a la versión más reciente del driver.

El siguiente ejemplo utiliza la biblioteca PHP de MongoDB, que ofrece una abstracción de alto nivel sobre el controlador PHP de nivel inferior:

$client = new MongoDB\Client(
    'mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority');
$db = $client-><databaseName>;

Versión de MongoDB	Versiones recomendadas de controladores
Todo	Consulte la matriz de compatibilidad de MongoDB para las últimas versiones recomendadas de controladores.
MongoDB 7.0 y versiones posteriores	PHPLIB 1.4 + mongodb-1.5.

Comportamiento

Los drivers de MongoDB intentan automáticamente seleccionar el servidor tras un evento de elección de clúster o conmutación por error. Por defecto, el driver genera inmediatamente un error si falla su primer intento de seleccionar un servidor. Los siguientes ajustes de configuración pueden mejorar la conectividad de una aplicación a un clúster de Atlas a costa de pasar más tiempo en un bucle de selección de servidor:

Configure serverSelectionTryOnce en false para dirigir al driver a realizar la selección del servidor hasta el límite de tiempo definido por serverSelectionTimeoutMS.
Reduzca el serverSelectionTimeoutMS a 15000 desde el valor por defecto de 30000. Las elecciones de MongoDB suelen tardar 10 segundos, pero pueden ser tan rápidas como 5 segundos en Atlas. Configurar este valor en 15 segundos (15000 milisegundos) cubre el límite superior de la elección más tiempo adicional para la latencia.

Nota

Para conectarte a un clúster de Atlas M0 o un clúster Flex, debes usar Python 2.7.9 o posterior y usar una versión del driver de Python que sea compatible con MongoDB 7.0 o posterior. Para obtener más información sobre la compatibilidad entre el driver de Python y MongoDB, consulta la matriz de compatibilidad de 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>

Versión de MongoDB	Versiones recomendadas de controladores
Todo	Consulte la matriz de compatibilidad de MongoDB para las últimas versiones recomendadas de controladores.
MongoDB 7.0 y versiones posteriores	Versión 3.7 o posterior

Nota

macOS y Python 3.6 Instaladores

A partir de https://www.python.org, los instaladores de Python 3.6 para macOS no instalan automáticamente ningún certificado de autoridad de certificación (CA). Sin los certificados de CA instalados, las conexiones a Atlas no pasarán la verificación de certificados.

Después de que ejecute el instalador desde https://www.python.org para instalar Python 3.6, debe ejecutar el siguiente script para instalar un paquete de CA actualizado antes de conectarse a Atlas:

open "/Applications/Python 3.6/Install Certificates.command"

Para obtener más información sobre los instaladores de Python 3.6 para macOS desde https://www.python.org, consulte https://bugs.python.org/issue29065#msg283984. Versiones anteriores de Python, así como Python 3.6 instaladas por otros medios (p. ej. Homebrew), no se verán afectadas.

Nota

Para realizar la conexión a un clúster Atlas M0 gratuito o un clúster Flex, se debe usar una versión del driver de Ruby que sea compatible con MongoDB 7.0 y versiones posteriores. Para obtener la documentación completa sobre la compatibilidad entre el driver de Ruby y MongoDB, se debe consultar la matriz de compatibilidad de MongoDB. Recomendamos actualizar a la versión más reciente del driver.

client = Mongo::Client.new('mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority')

Para conectarte a una base de datos distinta de admin pero aún autenticarte en la base de datos admin, actualiza el componente database de la cadena de conexión.

mongodb://username:password@host1:port1,...,hostN:portN/database?authSource=admin&...

Ejemplo

La siguiente cadena de conexión especifica la implementación cluster0 y el componente de base de datos test, e incluye la opción 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')

Versión de MongoDB	Versiones recomendadas de controladores
Todo	Consulte la matriz de compatibilidad de MongoDB para las últimas versiones recomendadas de controladores.
MongoDB 7.0 y versiones posteriores	Versión 2.6 o posterior

Ejemplo de 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

Versión de MongoDB	Versión mínima de ODM
MongoDB 7.0 y versiones posteriores	Versión 7.0.0 y posteriores

El tiempo de ejecución asíncrono por defecto utilizado por el driver es tokio. Para utilizar un tiempo de ejecución diferente, vea Configuración del tiempo de ejecución asíncrono.

Nota

Para realizar la conexión a un clúster de Atlas M0 gratuito o a un clúster Flex, se debe usar una versión del driver de Rust que sea compatible con MongoDB 7.0 y versiones posteriores. Para obtener la documentación completa sobre la compatibilidad entre el driver de Rust y MongoDB, se debe consultar la matriz de compatibilidad de MongoDB. Recomendamos actualizar a la versión más reciente del 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(())
    }

Versión de MongoDB	Versiones recomendadas de controladores
Todo	Consulte la matriz de compatibilidad de MongoDB para las últimas versiones recomendadas de controladores.

Asegúrese de haber activado la API de sincronización. Consulte Habilitación de la API de sincronización para obtener más detalles.

Nota

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(())
}

Versión de MongoDB	Versiones recomendadas de controladores
Todo	Consulte la matriz de compatibilidad de MongoDB para las últimas versiones recomendadas de controladores.

Nota

Para realizar la conexión a un clúster de Atlas M0 gratuito o a un clúster Flex, se debe usar una versión del driver de Scala que dé soporte a MongoDB 7.0 y versiones posteriores. Para obtener la documentación completa sobre la compatibilidad entre el driver de Scala y MongoDB, se debe consultar la matriz de compatibilidad de MongoDB. Recomendamos actualizar a la versión más reciente del 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>")

Versión de MongoDB	Versiones recomendadas de controladores
Todo	Consulte la matriz de compatibilidad de MongoDB para las últimas versiones recomendadas de controladores.

Nota

Para realizar la conexión a un clúster de Atlas M0 gratuito o a un clúster Flex, se debe usar una versión del driver de Swift que sea compatible con MongoDB 7.0 y versiones posteriores. Para obtener la documentación completa sobre la compatibilidad entre el driver de Swift y MongoDB, se debe consultar la matriz de compatibilidad de MongoDB. Recomendamos actualizar a la versión más reciente del 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())

Versión de MongoDB	Versiones recomendadas de controladores
Todo	Consulte la matriz de compatibilidad de MongoDB para las últimas versiones recomendadas de controladores.

Nota

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())

Versión de MongoDB	Versiones recomendadas de controladores
Todo	Consulte la matriz de compatibilidad de MongoDB para las últimas versiones recomendadas de controladores.

Solución de problemas

En caso de problemas para conectarse al clúster, consultar Solucionar problemas de conexión.

Tip

Límites de conexión y nivel de clúster

Volver

Conexión al clúster Atlas

Compass