드라이버 버전 업그레이드
개요
이 페이지에서는 새 버전의 C 운전자 로 업그레이드 할 때 애플리케이션 을 변경해야 하는 경우에 대해 설명합니다.
업그레이드하기 전에 다음 작업을 수행하세요:
새 C 운전자 버전이 애플리케이션 이 연결되는 MongoDB Server 버전 및 애플리케이션 이 실행되는 플랫폼과 호환되는지 확인합니다. 버전 호환성 정보는 C 운전자 호환성 페이지를 참조하세요.
애플리케이션 에서 사용하는 현재 운전자 버전과 업그레이드 예정 버전 간의 호환성이 손상되는 변경은 호환성이손상되는 변경 섹션에서 확인하세요. MongoDB Server 출시하다 호환성 변경 사항에 학습 보려면 서버 릴리스 호환성 변경 사항 섹션을 참조하세요.
팁
향후 운전자 버전을 업그레이드할 때 애플리케이션 에 필요한 변경 사항의 수를 최소화하려면 Stable API 를 사용합니다.학습 내용은 Stable API 가이드 를 참조하세요.
호환성이 손상되는 변경
참고
C 운전자 는 시맨틱 버전 관리를 따릅니다. 운전자 는 모든 출시하다 에서 빌드 시스템 또는 패키지 호환성을 손상시킬 수 있습니다. 패치 릴리스는 우발적인 API 호환성이 손상되는 변경을 되돌릴 수 있습니다.
호환성이 손상되는 변경은 드라이버의 특정 버전에서 시작되는 규칙 또는 동작의 변경입니다. 이러한 유형의 변경으로 인해 드라이버를 업그레이드하기 전에 해결하지 않으면 애플리케이션이 제대로 작동하지 않을 수 있습니다.
이 섹션의 호환성이 손상되는 변경은 이를 도입한 드라이버 버전별로 분류됩니다. 드라이버 버전을 업그레이드할 때 현재 버전과 업그레이드 버전 간의 호환성이 손상되는 변경을 모두 해소합니다.
예시
버전 1.26에서 업그레이드
C 운전자 를 버전 1.26 에서 1.27 버전으로 업그레이드하는 경우, 버전 1.27.0 에 대해 나열된 모든 호환성이 손상되는 변경을 1.27.6(있는 경우)로 주소 합니다.
버전 1.24.0 호환성이 손상되는 변경
C 운전자 를 구성하는 라이브러리 중 하나인 libmongoc의 1.24.0 출시하다 에는 다음과 같은 이전 버전과의 호환성이 호환성이 손상되는 변경 이 도입되었습니다.
Queryable Encryption 을 사용하려면 MongoDB Server 버전 7.0 이상이 필요합니다.
서버 릴리스 호환성 변경 사항
서버 출시 호환성 변경 사항은 MongoDB Server 버전 세트에 대한 지원을 중단하는 드라이버의 수정입니다.
드라이버는 MongoDB 서버 버전이 수명 종료(EOL) 시점에 도달하면 해당 버전에 대한 지원을 중단합니다.
EOL 제품에 대한 MongoDB 지원 에 학습 보려면 레거시 지원 정책을 참조하세요.
버전 1.28.0 릴리스 지원 변경 사항
이 운전자 버전은 MongoDB Server 버전 및 이전 버전에 대한 지원 3.6 을 중단합니다. 버전 이상의 운전자 1.28.0 를 사용하려면 MongoDB Server 4.0 버전이 이상이어야 합니다. 이 운전자 버전은 MongoDB Server 8.0 기능을 지원합니다. MongoDB Server 배포서버 서버를 업그레이드 하는 방법을 학습 보려면 MongoDB Server 매뉴얼의 릴리스 노트 를 참조하세요.