/ /

Configuración del clúster

Overview

En esta guía, puedes aprender cómo el driver Java gestiona los clústeres.

Puedes especificar la configuración de tus clústeres utilizando una cadena de conexión o pasando un objeto MongoClientSettings al constructor MongoClient. Selecciona la pestaña Connection String o MongoClientSettings para ver las opciones disponibles:

Incluya los siguientes parámetros en su cadena de conexión para modificar el comportamiento del controlador al interactuar con el clúster de MongoDB:

Nombre de la opción	Tipo	Descripción
`serverSelectionTimeoutMS`	entero	Especifica la cantidad máxima de tiempo, en milisegundos, que el controlador espera para que la selección del servidor tenga éxito antes de lanzar una excepción. por defecto: `30000` (30 segundos)
`localThresholdMS`	entero	Al comunicarse con múltiples instancias de MongoDB en un set de réplicas, el driver solo envía solicitudes a un servidor cuya respuesta es menor o igual a la del servidor con el tiempo de respuesta más rápido más el umbral local, en milisegundos. Por defecto: `15`
`replicaSet`	string	Especifica que la cadena de conexión proporcionada incluye varios hosts. Cuando se especifica, el driver intenta encontrar a todos los nodos de ese conjunto. Por defecto: `null`
`directConnection`	booleano	Especifica que el controlador debe conectarse directamente al host. Esto equivale a aplicar `mode(ClusterConnectionMode.SINGLE)` a tu `MongoClientSettings`. Por defecto: `false`
`loadBalanced`	booleano	Especifica si el driver se está conectando a MongoDB mediante un balanceador de carga o no. Por defecto: `null`
`srvServiceName`	string	Especifica el nombre del servicio de los registros de recursos SRV que el driver recupera para construir tu lista de nodos iniciales. Debe utilizar el formato de conexión de lista de nodos iniciales de DNS en su URI de conexión para usar esta opción. Por defecto: `mongodb`

Este ejemplo conecta el controlador directamente a un servidor, independientemente del tipo de clúster de MongoDB al que pertenezca:

ConnectionString connectionString = "mongodb://<host>:<port>/?directConnection=true"
MongoClient mongoClient = MongoClients.create(connectionString)

Para obtener más información sobre estos parámetros, consulta la Cadena de conexión documentación de la API.

Encadena el método applyToClusterSettings() para modificar el comportamiento del controlador al interactuar con tu clúster de MongoDB.

La siguiente tabla describe los métodos que puedes encadenar a tu configuración para modificar el comportamiento del driver:

Método

Descripción

addClusterListener()

Agrega un listener para eventos relacionados con el clúster.

applyConnectionString()

Usa los parámetros de un objeto ConnectionString.

applySettings()

Utiliza la configuración del clúster especificada en un objeto ClusterSettings.

hosts()

Configura todas las ubicaciones especificadas de una implementación Mongo.

localThreshold()

Define la cantidad de tiempo que puede tomar un viaje de ida y vuelta a un servidor y aún ser elegible para la selección de servidor.

Por defecto: 15 milliseconds

mode()

Configura cómo conectarse a una implementación de MongoDB.

requiredClusterType()

Establece el tipo de clúster requerido para el clúster.

requiredReplicaSetName()

Establece el nombre del set de réplicas requerido para el clúster.

serverSelectionTimeout()

Establece el tiempo máximo para seleccionar un nodo primario antes de lanzar una excepción por tiempo de espera.

Por defecto: 30 seconds

serverSelector()

Agrega un selector de servidor para aplicar antes de la selección del servidor.

srvHost()

Establece el nombre del host a usar para buscar un registro SRV DNS y encontrar los hosts de MongoDB.

Si deseas habilitar el procesamiento de registros TXT asociados con el host, especifica el host SRV en la cadena de conexión utilizando el método applyConnectionString().

Por ejemplo:

MongoClient mongoClient =
  MongoClients.create(MongoClientSettings.builder()
    .applyConnectionString(new ConnectionString("mongodb+srv://host1.acme.com")))

srvMaxHosts()

Establece el número máximo de hosts a los que el driver puede conectarse cuando se utiliza el protocolo de conexión de la lista de nodos iniciales DNS (SRV), identificado por el prefijo de la cadena de conexión mongodb+srv.

Lanza una excepción si no se utiliza el protocolo de conexión SRV.

Este ejemplo conecta el controlador directamente a un servidor, independientemente del tipo de clúster de MongoDB al que pertenezca:

MongoClient mongoClient = MongoClients.create(
    MongoClientSettings.builder()
    .applyToClusterSettings(builder ->
        builder.mode(ClusterConnectionMode.SINGLE))
    .build());

Tip

Esto es análogo al parámetro directConnection que puedes especificar en tu URI de conexión. Consulta la pestaña "Cadena de conexión" para obtener más información.

Para obtener más información acerca de los métodos encadenados, consulta la documentación de la API de MongoClientSettings.Builder .

Volver

Pools de conexiones

Configuraciones del servidor