Elija un destino de conexión

Overview

En esta guía, puede aprender a utilizar una cadena de conexión y MongoClient objeto para conectarse a diferentes tipos de implementaciones de MongoDB.

Atlas

Para conectarse a una implementación de MongoDB en Atlas, incluya los siguientes elementos en su cadena de conexión:

• URL de su clúster Atlas

• Nombre de usuario de MongoDB

• Contraseña de MongoDB

Luego, pase su cadena de conexión al método MongoClient.create().

Al conectarse a Atlas, recomendamos usar la opción de cliente API estable para evitar cambios importantes cuando Atlas se actualice a una nueva versión del servidor MongoDB. Para obtener más información sobre la función API estable, consulte Página API estable.

El siguiente código muestra cómo utilizar el controlador de Kotlin para conectarse a un clúster de Atlas. El código también utiliza la opción serverApi para especificar una versión estable de la API:

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

Implementaciones locales

Para conectarse a una implementación local de MongoDB, use localhost como nombre de host. De forma predeterminada, el proceso mongod se ejecuta en el puerto 27017, aunque puede personalizarlo para su implementación.

El siguiente código muestra cómo usar el controlador Kotlin para conectarse a una implementación local de MongoDB:

import com.mongodb.kotlin.client.coroutine.MongoClient
val uri = "mongodb://localhost:27017/"
val client = MongoClient.create(uri)

Sets de réplicas

Una implementación de un set de réplicas de MongoDB es un grupo de instancias conectadas que almacenan el mismo conjunto de datos. Esta configuración de instancias proporciona redundancia de datos y alta disponibilidad de datos.

Para conectarse a un conjunto de réplicas, especifique los nombres de host (o direcciones IP) y los números de puerto de los miembros del conjunto de réplicas.

Si no puede proporcionar una lista completa de hosts en el conjunto de réplicas, puede especificar uno o más de ellos e indicar al controlador de Kotlin que realice la detección automática para encontrar los demás. Para ello, realice una de las siguientes acciones:

• Especifique el nombre del conjunto de réplicas como el valor del parámetro replicaSet.

• Especifique false como el valor del parámetro directConnection.

• Especifica más de un host en el conjunto de réplicas.

Los siguientes ejemplos muestran cómo conectarse a un conjunto de réplicas de MongoDB que se ejecuta en el puerto 27017 de tres hosts diferentes mediante la clase ConnectionString o MongoClientSettings. Seleccione la pestaña que corresponda a su clase preferida.

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)

Detección de servicios DNS

Para usar la detección de servicios DNS y buscar el registro SRV DNS del servicio al que se conecta, especifique el formato de conexión SRV en la cadena de conexión. Además, si habilita el formato de conexión SRV, el controlador Kotlin vuelve a escanear automáticamente en busca de nuevos hosts sin tener que cambiar la configuración del cliente.

El siguiente código muestra una cadena de conexión que utiliza el formato de conexión SRV:

val uri = "mongodb+srv://<hostname>/"

Para obtener más información sobre el formato de conexión SRV, consulte la entrada Formato de conexión SRV en el manual del servidor MongoDB.

Documentación de la API

Para obtener más información sobre cómo crear un objeto MongoClient en el controlador Kotlin, consulte la siguiente documentación de API:

• MongoClient

• MongoClientSettings

• Cadena de conexión