MongoDB 서버 선택 사용자 지정

개요

모든 MongoDB 드라이버는 읽거나 쓰기 (write) 서버 선택할 때 정의된 알고리즘 따릅니다. MongoClient 객체 의 ClusterConfigurator 속성 사용하면 이 알고리즘 사용자 지정하여 애플리케이션 에 가장 적합한 서버 선택할 수 있습니다.

기본 알고리즘

.NET/ C# 드라이버 읽기 작업을 실행할 때 MongoDB deployment 선택하기 위해 다음 단계를 순서대로 수행합니다.

1. 알려진 서버 목록에서 활성 읽기 설정 (read preference) 일치하는 모든 서버를 선택합니다.

2. 읽을 수 있는 서버 하나 이상 있는 경우 운전자 사용자 정의 서버 선택기 함수를 호출하고 이전 단계의 목록을 전달합니다.

3. 함수에서 반환된 서버 목록에 LocalThreshold 연결 설정을 적용합니다.

4. 목록에 있는 서버에서 무작위로 서버 선택하고 이 서버 대해 작업을 실행합니다.

.NET/ C# 드라이버 쓰기 (write) 작업을 실행할 때 활성 읽기 설정 (read preference) 일치하는 서버뿐만 아니라 쓰기 가능한 모든 서버를 선택하는 것으로 시작합니다. 나머지 단계는 동일합니다.

기본값 서버 선택 알고리즘 을 지정하지 않을 때 운전자 사용하는 기본 서버 선택 알고리즘에 대해 자세히 학습 MongoDB Server 매뉴얼에서 서버 선택 알고리즘을 참조하세요.

다른 서버 선택 알고리즘 지정

서버 선택기 클래스의 인스턴스 ClusterConfigurator의 PreServerSelector 또는 PostServerSelector 속성 에 전달하여 다른 서버 선택 로직을 지정할 수 있습니다. PreServerSelector 속성 표준 서버 선택 로직이 실행되기 전에 실행되는 서버 선택기를 지정하고, PostServerSelector 속성 표준 서버 선택 로직이 실행된 후에 실행되는 서버 선택기를 지정합니다. 그런 다음 MongoClient 인스턴스 생성하여 사용자 지정 서버 선택 로직을 적용 할 때 ClusterConfigurator 인스턴스 MongoClientSettings 객체 에 전달할 수 있습니다.

다음 표에는 ClusterConfigurator 속성 에 전달할 수 있는 다양한 유형의 서버 선택기가 나열되어 있습니다.

다음 예시 표준 서버 선택 로직이 실행되기 전에 MongoClient 가 RandomServerSelector 클래스를 사용하여 무작위로 서버 선택하도록 지시합니다.

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);

다양한 서버 선택기 클래스에 대해 자세히 학습 ServerSelectors API 설명서를 참조하세요.

사용자 지정 서버 선택 로직 구현

IServerSelector 인터페이스에서 상속하고 SelectServers() 메서드를 재정의하는 클래스를 만들어 자체 사용자 지정 서버 선택 로직을 구현 수 있습니다. 다음 예시 에서는 ServerType 가 ServerType.ReplicaSetSecondary인 서버를 선택하는 간단한 사용자 지정 서버 선택 클래스를 보여 줍니다.

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

그런 다음 다른 서버 선택 알고리즘 지정 섹션에 표시된 대로 이 클래스의 인스턴스 인스턴스 의 PreServerSelector 또는 PostServerSelector 속성 에 전달할 수 ClusterConfigurator 있습니다.

설정을 사용하여 서버 선택 구성

MongoClient 객체 또는 연결 URI에서 다음 서버 선택 설정을 지정할 수 있습니다.

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

문제 해결

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>"
    }]
}.

API 문서

이 가이드 에 사용된 클래스 및 메서드에 대해 자세히 학습 다음 API 설명서를 참조하세요.

• 몽고클라이언트

• MongoClientSettings

• 클러스터 구성자

• ServerSelector

• IServerSelector

• SelectServer()