Conéctese a MongoDB

MongoClient

Puede conectarse y comunicarse con MongoDB utilizando la clase MongoClient.

Utilice el método MongoClient.create() para construir un MongoClient.

Para obtener más información sobre cómo funcionan los grupos de conexiones en el controlador, consulte la Página de preguntas frecuentes.

Todos los límites de uso de recursos, como las conexiones máximas, se aplican a instancias individuales MongoClient.

Para obtener más información sobre las diferentes configuraciones que puede utilizar para controlar el comportamiento de MongoClient su, consulte la guía sobre Configuración de MongoClient.

URI de conexión

El URI de conexión proporciona un conjunto de instrucciones que el driver utiliza para conectarte a una implementación de MongoDB. Instruye al driver sobre cómo debe conectarse a MongoDB y cómo debe comportarse mientras está conectado. En la siguiente figura, se explica cada parte de un URI de conexión de muestra:

Esta figura utiliza el formato de cadena de conexión estándar mongodb para el protocolo. También puede usar el formato de conexión de lista mongodb+srvde semillas DNS si desea mayor flexibilidad de implementación y la posibilidad de cambiar los servidores en rotación sin reconfigurar los clientes.

La siguiente parte del URI de conexión contiene sus credenciales si utiliza un mecanismo de autenticación basado en contraseña. Reemplace el valor user con el nombre de usuario de su base de datos y pass con la contraseña de dicho usuario. Si su mecanismo de autenticación no requiere credenciales, omita esta parte del URI de conexión.

La siguiente parte del URI de conexión especifica el nombre de host o la dirección IP, seguido del puerto de tu instancia de MongoDB. En el ejemplo, sample.host representa el nombre de host y 27017 es el número de puerto. Reemplaza estos valores para hacer referencia a tu instancia de MongoDB.

La última parte del URI de conexión contiene opciones de conexión como parámetros. En el ejemplo, se establecen dos opciones de conexión: maxPoolSize=20 w=majorityy. Para obtener más información sobre las opciones de conexión, consulte las opciones de conexión. sección de esta guía.

Ejemplo de Conexión de Atlas

Para conectarte a una implementación de MongoDB en Atlas, crea un cliente. Puedes crear un cliente que use tu cadena de conexión y otras opciones del cliente si trasladas un objeto MongoClientSettings al método MongoClient.create().

Para crear una instancia de un objeto MongoClientSettings, utiliza el método del compilador para especificar tu cadena de conexión y cualquier otra opción de cliente y, a continuación, llama al método build(). Encadena el método applyConnectionString() al compilador para especificar el URI de tu conexión.

Puedes configurar la opción de cliente de Stable API para evitar cambios disruptivos al actualizar a una nueva versión del servidor. Para obtener más información sobre la funcionalidad Stable API, consulta la página Stable API.

El siguiente código muestra cómo se puede especificar la cadena de conexión y la opción de cliente de la Stable API al conectarse a una implementación de MongoDB en Atlas y verificar que la conexión sea exitosa:

// Replace the placeholder with your Atlas connection string
val uri = "<connection string>"
// 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("admin")
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)
}

Otras formas de conectarse a MongoDB

Si se conecta a una única instancia de servidor MongoDB o un conjunto de réplicas que no está alojado en Atlas, consulte las siguientes secciones para saber cómo conectarse.

val connectionString = ConnectionString("mongodb://host1:27017,host2:27017,host3:27017/")
val mongoClient = MongoClient.create(connectionString)

val seed1 = ServerAddress("host1", 27017)
val seed2 = ServerAddress("host2", 27017)
val seed3 = ServerAddress("host3", 27017)
val settings = MongoClientSettings.builder()
    .applyToClusterSettings { builder ->
        builder.hosts(
            listOf(seed1, seed2, seed3)
        )
    }
    .build()
val mongoClient = MongoClient.create(settings)