Personalizar selección de servidor

Overview

Todos los drivers de MongoDB siguen un algoritmo definido al seleccionar un servidor del cual leer o al que guardar. Mediante el uso del ClusterConfigurator propiedad de un objeto MongoClient, puedes personalizar este algoritmo para elegir el servidor que funcione mejor para tu aplicación.

Algoritmo por defecto

Cuando el controlador .NET/C# ejecuta una operación de lectura, realiza los siguientes pasos, en orden, para seleccionar una implementación de MongoDB:

1. Selecciona todos los servidores que coincidan con la preferencia de lectura activa de la lista de servidores conocidos.

2. Si existe al menos un servidor legible, el controlador llama a la función selector de servidores definida por el usuario y le 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 un servidor al azar de la lista de servidores disponibles y ejecuta la operación en él.

Cuando el driver de .NET/C# ejecuta una operación de escritura, comienza seleccionando todos los servidores escribibles, no solo aquellos que coinciden con la preferencia de lectura activa. Los pasos restantes son idénticos.

Para aprender más sobre el algoritmo de selección de servidores predeterminado, que el driver sigue cuando no especificas ninguna lógica de selección de servidores personalizada, consulta Algoritmo de selección de servidor en el manual del MongoDB Server.

Especificar otros algoritmos de selección de servidor

Se puede especificar una lógica diferente de selección de servidor pasando una instancia de una clase de selector de servidor a la propiedad PreServerSelector o PostServerSelector del ClusterConfigurator. La propiedad PreServerSelector es una propiedad que especifica un selector de servidor que se ejecuta antes de la lógica estándar de selección de servidor, mientras que la propiedad PostServerSelector es una propiedad que especifica un selector de servidor que se ejecuta después de que se ejecute la lógica estándar de selección de servidor. Luego, puedes pasar tu instancia de ClusterConfigurator al objeto MongoClientSettings cuando crees una instancia de MongoClient para aplicar tu lógica personalizada de selección de servidor.

La siguiente tabla enumera los diferentes tipos de selectores de servidor que puedes pasar a la propiedad ClusterConfigurator:

El siguiente ejemplo indica a un MongoClient que use la clase RandomServerSelector para seleccionar un servidor al azar antes de que se ejecute la lógica de selección de servidor estándar:

var settings = MongoClientSettings.FromConnectionString("<connection string>");
var clusterConfigurator = builder =>
{
    builder.ConfigureCluster(c =>
        c.With(PreServerSelector: new RandomServerSelector()));
};
settings.ClusterConfigurator = clusterConfigurator;
var client = new MongoClient(settings);

Para obtener más información sobre las diferentes clases de selector de servidores, consulta la documentación de la API ServerSelectors.

Implementación de lógica personalizada de selección de servidores.

Puedes implementar tu propia lógica personalizada de selección de servidores creando una clase que herede de la interfaz IServerSelector y anule el método SelectServers(). El siguiente ejemplo muestra una clase simple de selección de servidores personalizada que selecciona servidores con un ServerType de ServerType.ReplicaSetSecondary:

public class CustomServerSelector : IServerSelector
{
    public IEnumerable<ServerDescription> SelectServers(ClusterDescription cluster,
        IEnumerable<ServerDescription> servers)
    {
        return servers.Where(server => server.Type == ServerType.ReplicaSetSecondary);
    }
}

A continuación, puedes pasar una instancia de esta clase a la propiedad PreServerSelector o PostServerSelector de una instancia de ClusterConfigurator, como se muestra en la sección Especificando Otros Algoritmos de Selección de Servidores.

Uso de Configuración para elegir el servidor

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

Solución de problemas

A timeout occurred after 30000ms selecting a server using CompositeServerSelector{ Selectors = MongoDB.Driver.MongoClient+AreSessionsSupportedServerSelector, LatencyLimitingServerSelector{ AllowedLatencyRange = 00:00:00.0150000 }, OperationsCountServerSelector }.
Client view of cluster state is
{
    ClusterId : "1",
    Type : "Unknown",
    State : "Disconnected",
    Servers :
    [{
        ServerId: "{ ClusterId : 1, EndPoint : "Unspecified/localhost:27017" }",
        EndPoint: "Unspecified/localhost:27017",
        ReasonChanged: "Heartbeat",
        State: "Disconnected",
        ServerVersion: ,
        TopologyVersion: ,
        Type: "Unknown",
        HeartbeatException: "<exception details>"
    }]
}.

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

• ClusterConfigurator

• ServerSelectors

• IServerSelector

• SelectServer()