Personalizar selección de servidor

Overview

Todos los controladores de MongoDB siguen un algoritmo definido al seleccionar un servidor desde el que leer o escribir. Al usar el ClusterConfigurator propiedad de un objeto MongoClient, puede personalizar este algoritmo para elegir el servidor que funcione mejor para su aplicación.

Algoritmo predeterminado

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 de selección de servidor definida por el usuario y pasa la lista del paso anterior.

3. Aplica la configuración de conexión LocalThreshold a la lista de servidores devueltos 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 controlador .NET/C# ejecuta una operación de escritura, comienza seleccionando todos los servidores con permisos de escritura, no solo aquellos que coinciden con la preferencia de lectura activa. Los pasos restantes son idénticos.

Para obtener más información sobre el algoritmo de selección de servidor predeterminado, que sigue el controlador cuando no especifica ninguna lógica de selección de servidor personalizada, consulte Algoritmo de selección de servidor en el manual del servidor MongoDB.

Especificación de otros algoritmos de selección de servidores

Puede especificar una lógica de selección de servidor diferente pasando una instancia de una clase de selector de servidor a la propiedad PreServerSelector o PostServerSelector de ClusterConfigurator. La propiedad PreServerSelector especifica un selector de servidor que se ejecuta antes de la lógica de selección de servidor estándar, mientras que la propiedad PostServerSelector especifica un selector de servidor que se ejecuta después de esta. Después, puede pasar su instancia ClusterConfigurator al objeto MongoClientSettings al crear una instancia MongoClient para aplicar su lógica de selección de servidor personalizada.

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

El siguiente ejemplo indica a MongoClient que utilice 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 servidor, consulte la documentación de la API de ServerSelectors.

Implementación de lógica de selección de servidor personalizado

Puede implementar su propia lógica de selección de servidores personalizada creando una clase que herede de la interfaz IServerSelector y sobrescriba el método SelectServers(). El siguiente ejemplo muestra una clase de selección de servidores personalizada simple que selecciona servidores con un valor de 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);
    }
}

Luego puede pasar una instancia de esta clase a la propiedad PreServerSelector o PostServerSelector de una ClusterConfigurator instancia, como se muestra en la sección Especificación de otros algoritmos de selección de servidor.

Uso de configuraciones para configurar la selección del servidor

Puede especificar las siguientes configuraciones de selección de servidor en su objeto MongoClient o en su 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

• Configurador de clúster

• Selectores de servidor

• Selector de servidor I

• SeleccionarServidor()