문서 메뉴
문서 홈
/ / /
C#/.NET

드라이버 버전 업그레이드

이 페이지의 내용

  • 개요
  • 주요 변경 사항
  • 서버 릴리스 호환성 변경 사항

이 섹션에서는 드라이버를 새 버전으로 업그레이드할 때 애플리케이션에 적용해야 하는 필수 변경 사항을 확인할 수 있습니다.

업그레이드하기 전에 다음 작업을 수행하세요:

  • 새 버전이 애플리케이션이 연결되는 MongoDB Server 버전 및 애플리케이션이 실행되는 .NET 프레임워크 버전과 호환되는지 확인하세요. 이 정보는 .NET/C# 드라이버 호환성 페이지를 참조하세요.

  • 애플리케이션에서 사용 중인 드라이버의 현재 버전과 업그레이드 예정 버전 간의 호환성이 손상되는 변경은 호환성이 손상되는 변경 섹션에서 확인하세요. MongoDB Server 릴리스 호환성 변경 사항에 대해 자세히 알아보려면 MongoDB Server 릴리스 호환성 변경 사항 섹션을 참조하세요.

향후 드라이버 버전을 업그레이드할 때 애플리케이션에 필요한 변경 사항을 최소화하려면 Stable API를 사용하세요.

호환성이 손상되는 변경은 드라이버의 특정 버전에서 시작되는 규칙 또는 동작의 수정입니다. 이러한 유형의 변경으로 인해 드라이버를 업그레이드하기 전에 해결하지 않으면 애플리케이션이 제대로 작동하지 않을 수 있습니다.

이 섹션의 호환성이 손상되는 변경은 이를 도입한 드라이버 버전별로 분류되어 있습니다. 드라이버 버전을 업그레이드할 때 현재 버전과 업그레이드 버전 간의 호환성이 손상되는 변경을 모두 해결하세요. 예를 들어 드라이버를 v2.0 에서 v2.20으로 업그레이드하는 경우 v2.0 이후 버전( v2.20에 나열된 변경 포함)의 모든 호환성이 손상되는 변경을 해결합니다.

  • 모든 .NET/C# 드라이버 구성 요소에는 강력한 이름이 지정됩니다. 드라이버 버전 2.28 이상을 사용 중이고 애플리케이션에 여러 .NET/C# 드라이버 버전을 참조하는 종속성이 있는 경우 다음 예제와 같이 바인딩 리디렉션을 만들어야 합니다.

    <configuration>
    <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    <dependentAssembly>
    <assemblyIdentity name="MongoDB.Driver"
    publicKeyToken="94992a530f44e321"
    culture="neutral" />
    <bindingRedirect oldVersion="2.28.0.0"
    newVersion="<version number to use>" />
    </dependentAssembly>
    <dependentAssembly>
    <assemblyIdentity name="MongoDB.Bson"
    publicKeyToken="94992a530f44e321"
    culture="neutral" />
    <bindingRedirect oldVersion="2.28.0.0"
    newVersion="<version number to use>" />
    </dependentAssembly>
    <dependentAssembly>
    <assemblyIdentity name="MongoDB.Driver.Core"
    publicKeyToken="94992a530f44e321"
    culture="neutral" />
    <bindingRedirect oldVersion="2.28.0.0"
    newVersion="<version number to use>" />
    </dependentAssembly>
    </assemblyBinding>
    </runtime>
    </configuration>
  • Atlas Search 빌더에서 Render 메서드의 함수 서명이 변경되었습니다. 다음 코드 스니펫은 변경 전과 변경 후의 함수 시그니처를 보여줍니다.

    // Render function signature prior to v2.21.0
    Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry);
    // Render function signature in v2.21.0 and later
    Render(SearchDefinitionRenderContext<TDocument> renderContext);
  • ObjectSerializer는 안전하다고 간주되는 유형의 역직렬화만 허용합니다. 달리 지정하지 않으면 ObjectSerializerObjectSerializer.DefaultAllowedTypes에서 반환된 유형을 사용합니다.

    ObjectSerializer 에 대해 자세히 알아보려면 FAQ 를 참조하세요. 에 대한 DefaultAllowedTypes 자세한 내용은 API 설명서를 참조하세요.

  • 기본 LinqProvider는 LINQ3로 변경되었습니다. 다음 코드 예시와 같이 MongoClientSettings에서 LINQ2에 대해 LinqProvider를 구성할 수 있습니다.

    var connectionString = "<connection string>";
    var clientSettings = MongoClientSettings
    .FromConnectionString(connectionString);
    clientSettings.LinqProvider = LinqProvider.V2;
    var client = new MongoClient(clientSettings);
  • 해당 MongoDB .NET/C# 드라이버 버전은 .NET 프레임워크 v4.5.2 또는 이전 버전에 대한 지원을 제거했습니다. 지원되는 최소 .NET 프레임워크는 v4.7.2 버전입니다.

  • 이 버전의 MongoDB .NET/C# 드라이버는 .NET Standard v1.5를 지원하지 않습니다. 지원되는 최소 .NET Standard는 v2.0 입니다.

  • slave0k 문자열 옵션이 제거되었습니다. 이제 readPreference 옵션이 대신 사용됩니다.

서버 릴리스 호환성 변경은 일련의 MongoDB Server 버전에 대한 지원을 중단하는 MongoDB .NET/C# 드라이버의 수정 사항입니다.

드라이버는 MongoDB 서버 버전이 수명 종료(EOL) 시점에 도달하면 해당 버전에 대한 지원을 중단합니다.

EOL 제품에 대한 MongoDB 지원에 대해 자세히 알아보려면 레거시 지원 정책을 참조하세요.

.NET/C# 드라이버 버전과 MongoDB Server 버전 간의 호환성에 대해 자세히 알아보려면 호환성 페이지를 방문하세요.

이제 v2.14 드라이버는 MongoDB Server 3.4 이전 버전을 지원하지 않습니다. v2.14의 모든 드라이버를 사용하려면 이후 버전에서는 MongoDB Server가 반드시 3.6 이후 버전이어야 합니다.

MongoDB Server 배포를 업그레이드하는 방법을 알아보려면 MongoDB Server 매뉴얼의 릴리스 노트를 참조합니다.

돌아가기

호환성