Docs Menu
Docs Home
/
언어
/
C#/.NET
/
C#/.NET

드라이버 버전 업그레이드

이 페이지의 내용

  • 개요
  • 호환성이 손상되는 변경
  • 서버 릴리스 호환성 변경 사항

개요

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

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

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

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

팁

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

호환성이 손상되는 변경

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

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

버전 2.19.0 호환성이 손상되는 변경

  • ObjectSerializer 는 안전한 것으로 간주되는 유형의 역직렬화만 허용합니다. 달리 지정하지 않으면 ObjectSerializer 는 ObjectSerializer.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);

버전 2.14.0 호환성이 손상되는 변경

  • 해당 MongoDB .NET/C# 드라이버 버전은 .NET 프레임워크 v4.5.2 또는 이전 버전에 대한 지원을 제거했습니다. 지원되는 최소 .NET 프레임워크는 v4.7.2 버전입니다.

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

버전 2.13.0 호환성이 손상되는 변경

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

서버 릴리스 호환성 변경 사항

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

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

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

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

버전 2.14 릴리스 지원 변경 사항

  • v2.14 드라이버는 MongoDB Server v3.4 및 이전 버전에 대한 지원을 중단합니다. v2.14 이상에서 드라이버를 사용하려면 MongoDB Server가 v3.6 또는 그 이후 버전. MongoDB Server를 v3.6 으로 업그레이드하는 방법을 알아보려면 사용 중인 MongoDB 배포 구성에 해당하는 링크를 따라가세요.

돌아가기

호환성