Personalizar selección de servidor

Overview

Todos los drivers de MongoDB siguen un algoritmo definido al seleccionar un servidor para leer o guardar. Al usar la propiedad ClusterSettings de un objeto MongoClientSettings, puedes personalizar este algoritmo para elegir el servidor que mejor funcione para tu aplicación.

Algoritmo de selección de servidor

Cuando el driver de Kotlin Sync ejecuta una operación de lectura, realiza los siguientes pasos, en orden, para seleccionar una implementación de MongoDB:

1. Selecciona todos los servidores de la lista de servidores conocidos aptos para la operación solicitada, excluyendo aquellos que el controlador considera no disponibles o problemáticos

   1. Para las lecturas, selecciona todos los servidores que coinciden con la preferencia de lectura activa.

   2. Para escrituras, selecciona todos los servidores escribibles

2. Llama a la función definidor de servidor definida por el usuario, si el usuario proporciona una, y pasa la lista del paso anterior

3. Aplica la configuración de conexión localThreshold a la lista de servidores devuelta por la función.

4. Selecciona como máximo dos servidores aleatorios de la lista de servidores que cumplen con los criterios anteriores y, a continuación, selecciona el servidor con menos operaciones simultáneas pendientes.

Cuando el controlador de sincronización de Kotlin ejecuta una operación de guardado, comienza seleccionando todos los servidores en los que se puede guardar de la lista de servidores conocidos, no solo aquellos que coinciden con la preferencia de lectura activa. El resto de los pasos son idénticos a los de la lista anterior.

Para obtener más información sobre el algoritmo de selección de servidores de MongoDB, consulte Algoritmo de selección de servidores en el manual de MongoDB Server.

Implementar lógica de selección de servidor personalizada

Puedes implementar tu propia lógica personalizada de selección de servidores creando una clase que implemente la interfaz ServerSelector. El siguiente ejemplo muestra una clase personalizada simple de selección de servidores que selecciona los servidores con un valor de type de ServerType.REPLICA_SET_SECONDARY:

class CustomServerSelector : ServerSelector {
    override fun select(cluster: ClusterDescription): List<ServerDescription> {
        return cluster.serverDescriptions.filter { it.type == ServerType.REPLICA_SET_SECONDARY }
    }
}

Utiliza el método applyToClusterSettings() para pasar una instancia de esta clase a tu MongoClientSettings. El siguiente ejemplo muestra cómo crear un MongoClient con una instancia de la clase de selector de servidor personalizada del ejemplo anterior:

val settings = MongoClientSettings.builder()
    .applyConnectionString(ConnectionString("<connection URI>"))
    .applyToClusterSettings { builder ->
        builder.serverSelector(CustomServerSelector())
    }
    .build()
val mongoClient = MongoClient.create(settings)

Configura la selección de servidores en Configuración

Puedes especificar las siguientes configuraciones de selección del servidor en tu objeto MongoClient o en tu URI de conexión:

readPreference=primaryPreferred
&maxStalenessSeconds=90
&readPreferenceTags=dc:ny,rack:1

Documentación de la API

Para obtener más información sobre las clases y métodos utilizados en esta guía, consulta la siguiente documentación de la API:

• MongoClient

• MongoClientSettings

• ServerSelector

• preferencia de lectura