클라이언트 라이브러리 호환성 테이블 - 클라이언트 라이브러리

팁

C 드라이버를 다운로드하고 첫 번째 애플리케이션을 만드는 방법은 시작하기를 참조하세요.

MongoDB 서버 호환성

이 섹션에서는 MongoDB Server 버전과 운전자 버전 간의 호환성에 대해 설명합니다. 다음 표에서는 호환성 수준을 설명합니다.

Icon	설명
✓	모든 기능이 지원됩니다.
⊛	드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
✗	드라이버 버전은 MongoDB 버전에서 작동하지 않습니다. MongoDB 버전에 연결을 시도하면 오류가 발생합니다.
표시 없음	드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

다음 표는 C 드라이버와 MongoDB Server 간의 호환성을 보여줍니다.

C 드라이버 버전	MongoDB 9.0	MongoDB 8.0	MongoDB 7.0	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2
2.5	✓	✓	✓	✓	✓	✓	✓
2.3 ~ 2.4	⊛	✓	✓	✓	✓	✓	✓
1.28 ~ 2.2		✓	✓	✓	✓	✓	✓
1.24 ~ 1.27		⊛	✓	✓	✓	✓	✓
1.22 ~ 1.23		⊛	⊛	✓	✓	✓	✓
1.19 ~ 1.21		⊛	⊛	⊛	✓	✓	✓
1.18		⊛	⊛	⊛	✓ [1]	✓	✓
1.17		⊛	⊛	⊛	⊛	✓	✓
1.15 ~ 1.16		⊛	⊛	⊛	⊛	⊛	✓
1.11 ~ 1.14		⊛	⊛	⊛	⊛	⊛	⊛

[1]	1.18 드라이버는 세컨더리에서 스냅샷 읽기를 지원하지 않습니다. 자세한 내용은 MongoDB Server 버전 5.0 릴리스 정보를 참조하세요.

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

애플리케이션 현재 지원되는 MongoDB 버전에서 작동하는 경우 9.0에서도 작동해야 하지만, 비프로덕션 환경에서 테스트할 것을 적극 권장합니다. 부분적으로 호환되는 운전자 버전은 연결 중인 MongoDB Server 버전의 모든 새로운 기능 지원 하지 않습니다. 2.3 와 2.4 사이의 모든 버전의 C 드라이버는 MongoDB Server 9.0과 부분적으로 호환됩니다.

애플리케이션 MongoDB 9.0에서 작동하지 않는 경우, 해당 애플리케이션과 완전히 호환되는(✓) 드라이버 버전으로 업그레이드하는 것이 좋습니다. C 드라이버의 경우 여기에는 버전 2.5 이상이 포함됩니다. 완전히 호환되는 드라이버 버전을 사용하면 장기적인 안정성이 보장되고 애플리케이션이 최신 MongoDB 기능을 사용할 수 있습니다.

각 운전자 버전에 추가되거나 제거된 기능 목록은 드라이버의 출시하다 노트를 참조하세요. 각 MongoDB Server 버전에 추가되거나 제거된 기능 목록은 MongoDB Server 출시 노트를 참조하세요.

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

현재 MongoDB Server 버전이 수명 종료(EOL) 날짜에 도달하여 드라이버 버전을 업그레이드하는 경우, MongoDB 버전과 완전히 호환되는(✓) 드라이버 버전을 사용하는 것이 좋습니다. 예시를 들어 MongoDB Server 8.0으로 업그레이드하는 경우 C 드라이버 버전 1.28 이상을 사용할 수 있습니다.

그러나 MongoDB Server 9.0으로 업그레이드하는 경우 운전자 버전 2.5 이상으로 업그레이드하는 것이 좋습니다. 이렇게 하면 애플리케이션이 MongoDB Server 9.0 에서 제공되는 모든 기능을 사용할 수 있으며 향후 버전과의 텀 호환성을 제공할 수 있습니다.

내 운전자 버전은 언제 EOL에 도달하나요?

새 운전자 버전은 지난 3년 이내에 EOL에 도달한 모든 MongoDB Server 버전과 완벽하게 호환됩니다. 이 기간이 지나면 새 운전자 버전이 EOL MongoDB Server 버전과 완전히 호환되지 않을 수 있습니다.

예시 들어, MongoDB Server 8.0은 2029년 월부로 EOL되었습니다. 8월 2032 까지의 모든 C 드라이버 릴리스는 MongoDB Server 8.0과 완전히 호환됩니다.

장기적인 호환성과 보안을 보장하려면 MongoDB Server 버전이 만료되기 전에 운전자 업그레이드하는 것이 좋습니다. MongoDB Server 출시하다 및 EOL 날짜에 대한 자세한 학습 은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

C 호환성

이 섹션에서는 C 드라이버 버전과 C 버전 간의 호환성을 보여 줍니다. 세를에 확인 표시(✓)가 있으면 C 드라이버 버전이 C 버전과 완전히 호환된다는 의미입니다. 빈 세를은 조합이 호환되지 않거나 테스트되지 않음을 의미합니다.

다음 표는 C 드라이버와 C 언어 간의 호환성을 보여줍니다.

C 드라이버 버전	C17/C18	C11	C99	C89
1.24 ~ 2.5	✓	✓	✓
<= 1.23		✓	✓	✓

플랫폼 호환성

이 섹션에서는 C 드라이버가 지원하는 플랫폼 및 도구 체인에 대한 호환성 정보를 보여줍니다.

운영 체제

C 드라이버와 함께 사용할 수 있도록 지원되는 운영 체제는 다음과 같습니다.

운영 체제	참고 사항
Debian	버전 11.0 이상
RHEL	버전 7.0 이상. 동일한 출시하다 버전의 RHEL 파생 제품(예: CentOS, Rocky Linux 및 AlmaLinux)이 지원됩니다. Fedora도 지원됩니다.
Ubuntu	버전 20.04 이상. 지원되는 Ubuntu 버전을 기반으로 하는 Ubuntu 파생 제품도 지원됩니다.
Arch Linux
macOS	C 드라이버 버전 2.1 이하를 사용하려면 macOS 11.0 이상이 필요합니다. C 드라이버 버전 2.2 이상을 사용하려면 macOS 14.0 이상이 필요합니다.
Windows	Windows Server 2008 이상

컴파일러

다음 컴파일러는 C 운전자 사용하여 지속적으로 테스트됩니다.

컴파일러	참고 사항
Clang	버전 3.7, 3.8, 6.0. 최신 버전과 해당 Apple Clang 릴리스도 지원됩니다.
GNU 컴파일러 컬렉션(GCC)	버전 4.8, 5.4, 6.3, 7.5, 8.2, 8.3, 9.4 및 10.2. MinGW-w64 GCC도 테스트되고 지원됩니다.
Microsoft Visual C++(MSVC)	15.x(Visual Studio 2017)로 테스트되었습니다. 최신 MSVC 버전이 지원되지만 아직 테스트되지 않았습니다.

아키텍처

다음 CPU 아키텍처는 C 운전자 사용하여 지속적으로 테스트됩니다.

아키텍처	참고 사항
x86 (32-비트)	Windows 에서만 테스트됨
x86_64 (64-비트 x86)	Linux, macOS, Windows에서 테스트 완료
ARM /arch64	macOS 및 Linux에서 테스트 완료
Power8 (ppc64파일)	Linux 에서만 테스트됨
IBM Z 시리즈(s390x)	Linux 에서만 테스트됨

추가 플랫폼

다른 플랫폼과 툴체인은 테스트되지 않았지만, 이전 플랫폼의 유사한 버전이 작동할 것으로 예상합니다. 작동할 것으로 예상하는 플랫폼 또는 툴체인을 발견했는데 작동하지 않는 경우, 문제를 설명하는 Jira 이슈를 열거나 GitHub 풀 요청 를 열어 해결하세요.

중요

지원되지 않는 플랫폼을 수정하기 위한 간단한 pull 요청은 환영하지만, 이는 사례별로 고려될 예정입니다. 지원되지 않는 플랫폼에서 라이브러리를 수정하기 위해 pull 요청 병합하는 것이 해당 플랫폼에 대한 완전한 지원 의미하지는 않습니다.

팁

C++ 드라이버를 다운로드하고 첫 번째 애플리케이션을 만드는 방법을 학습하려면 시작하기를 참조하세요.

MongoDB 서버 호환성

이 섹션에서는 MongoDB Server 버전과 운전자 버전 간의 호환성에 대해 설명합니다. 다음 표에서는 호환성 수준을 설명합니다.

Icon	설명
✓	모든 기능이 지원됩니다.
⊛	드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
✗	드라이버 버전은 MongoDB 버전에서 작동하지 않습니다. MongoDB 버전에 연결을 시도하면 오류가 발생합니다.
표시 없음	드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

다음 표는 C++ 드라이버와 MongoDB Server 간의 호환성을 보여줍니다.

C++ 드라이버 버전	MongoDB 9.0	MongoDB 8.0	MongoDB 7.0	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2
4.6	✓	✓	✓	✓	✓	✓
4.3 ~ 4.5	⊛	✓	✓	✓	✓	✓
4.2		✓	✓	✓	✓	✓
3.11 ~ 4.1		✓	✓	✓	✓	✓	✓
3.8 ~ 3.10		⊛	✓	✓	✓	✓	✓
3.7		⊛	⊛	⊛	✓	✓	✓
3.6		⊛	⊛	⊛	⊛	✓	✓
3.4 ~ 3.5		⊛	⊛	⊛	⊛	⊛	⊛

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

애플리케이션 현재 지원되는 MongoDB 버전에서 작동하는 경우 9.0에서도 작동해야 하지만, 비프로덕션 환경에서 테스트할 것을 적극 권장합니다. 부분적으로 호환되는 운전자 버전은 연결 중인 MongoDB Server 버전의 모든 새로운 기능 지원 하지 않습니다. 4.3 부터 4.5 까지 모든 버전의 C++ 드라이버는 MongoDB Server 9.0과 부분적으로 호환됩니다.

애플리케이션 MongoDB 9.0에서 작동하지 않는 경우, 해당 애플리케이션과 완전히 호환되는(✓) 드라이버 버전으로 업그레이드하는 것이 좋습니다. C++ 드라이버의 경우 여기에는 버전 4.6 이상이 포함됩니다. 완전히 호환되는 드라이버 버전을 사용하면 장기적인 안정성이 보장되고 애플리케이션이 최신 MongoDB 기능을 사용할 수 있습니다.

각 운전자 버전에 추가되거나 제거된 기능 목록은 드라이버의 출시하다 노트를 참조하세요. 각 MongoDB Server 버전에 추가되거나 제거된 기능 목록은 MongoDB Server 출시 노트를 참조하세요.

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

현재 MongoDB Server 버전이 수명 종료(EOL) 날짜에 도달하여 드라이버 버전을 업그레이드하는 경우, MongoDB 버전과 완전히 호환되는(✓) 드라이버 버전을 사용하는 것이 좋습니다. 예시를 들어 MongoDB Server 8.0으로 업그레이드하는 경우 C++ 드라이버 버전 3.11 이상을 사용할 수 있습니다.

그러나 MongoDB Server 9.0으로 업그레이드하는 경우 운전자 버전 4.6 이상으로 업그레이드하는 것이 좋습니다. 이렇게 하면 애플리케이션이 MongoDB Server 9.0 에서 제공되는 모든 기능을 사용할 수 있으며 향후 버전과의 텀 호환성을 제공할 수 있습니다.

내 운전자 버전은 언제 EOL에 도달하나요?

새 운전자 버전은 지난 3년 이내에 EOL에 도달한 모든 MongoDB Server 버전과 완벽하게 호환됩니다. 이 기간이 지나면 새 운전자 버전이 EOL MongoDB Server 버전과 완전히 호환되지 않을 수 있습니다.

예시, MongoDB Server 8.0은 2029월 일부로 EOL입니다. 8월 2032 까지 모든 C++ 드라이버 릴리스 MongoDB Server 8.0과 완전히 호환됩니다.

장기적인 호환성과 보안을 보장하려면 MongoDB Server 버전이 만료되기 전에 운전자 업그레이드하는 것이 좋습니다. MongoDB Server 출시하다 및 EOL 날짜에 대한 자세한 학습 은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

C++ 호환성

이 섹션에서는 C++ 드라이버 버전과 C++ 버전 간의 호환성을 표시합니다. 세포에 표시된 확인 표시(✓)는 C++ 드라이버 버전이 C++ 버전과 완전히 호환되는 경우를 의미합니다. 빈 세를 조합이 호환되지 않거나 테스트되지 않았다는 의미입니다.

다음 표는 C++ 와 MongoDB Server 간의 호환성을 보여줍니다.

C++ 드라이버 버전	C++23	C++20	C++17	C++14	C++11
3.8 ~ 4.6	✓	✓	✓	✓	✓
3.0 ~ 3.7			✓	✓	✓

libmongoc 호환성

다음 표는 C++ 드라이버의 각 버전에 대한 최소 libmongoc 버전을 보여줍니다.

C++ 드라이버 버전	최소 libmongoc 버전
4.6.x	2.5.6
4.5.x	2.3.3
4.4.x	2.3.1
4.3.x	2.3.0
4.2.x	2.2.3
4.1.x	2.0.0
4.0.x	1.29.0
3.11.x	1.28.0
3.9.x 및 3.10.x	1.25.0
3.8.x	1.24.0
3.7.x	1.22.1
3.6.x	1.17.0
3.5.x	1.15.0
3.4.x	1.13.0
3.3.x	1.10.0
3.2.x	1.9.2
3.1.4	1.7.0
3.1.0 ~ 3.1.3	1.5.0
3.0.1 ~ 3.0.3	1.3.4
3.0.0	1.3.1

컴파일러 호환성

C++ 운전자 다음 컴파일러를 지원합니다.

GCC v8.1 이상
Clang v3.8 이상
Xcode v13.1 이상
Visual Studio 2017 버전 15.9 이상

참고

앞의 컴파일러 버전은 소스에서 C++ 운전자 빌드 데 필요한 최소 버전입니다. 이는 사전 빌드된 헤더 및 라이브러리를 사용하기 위한 요구 사항이 아닙니다.

팁

NET/C# 드라이버를 다운로드하고 첫 애플리케이션을 만드는 방법을 학습하려면 시작하기를 참조하세요.

MongoDB 서버 호환성

이 섹션에서는 MongoDB Server 버전과 운전자 버전 간의 호환성에 대해 설명합니다. 다음 표에서는 호환성 수준을 설명합니다.

Icon	설명
✓	모든 기능이 지원됩니다.
⊛	드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
✗	드라이버 버전은 MongoDB 버전에서 작동하지 않습니다. MongoDB 버전에 연결을 시도하면 오류가 발생합니다.
표시 없음	드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

다음 표는 .NET/ C# 운전자 와 MongoDB Server 간의 호환성을 보여줍니다.

.NET/C# 드라이버 버전	MongoDB 9.0	MongoDB 8.2 ~ 8.3	MongoDB 8.1	MongoDB 8.0	MongoDB 7.0	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2
3.10 ~ 3.12	✓	✓	✓	✓	✓	✓	✓	✓
3.8 ~ 3.9	⊛	✓	✓	✓	✓	✓	✓	✓	✓
2.29 ~ 3.7		⊛	✓	✓	✓	✓	✓	✓	✓
2.20 ~ 2.28		⊛	⊛	⊛	✓	✓	✓	✓	✓
2.16 ~ 2.19		⊛	⊛	⊛	⊛	✓	✓	✓	✓
2.15		⊛	⊛	⊛	⊛	⊛	✓	✓	✓
2.7 ~ 2.14		✗ [2]	✗ [2]	⊛	⊛	⊛	⊛	✓	✓
2.0 ~ 2.6		✗ [2]	✗ [2]						✓

[2]	(1, 2, 3, 4) 이러한 운전자 버전은 인증 문제로 인해 MongoDB Server 8.1 이상과 호환되지 않습니다.

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

애플리케이션 현재 지원되는 MongoDB 버전에서 작동하는 경우 9.0에서도 작동해야 하지만, 비프로덕션 환경에서 테스트할 것을 적극 권장합니다. 부분적으로 호환되는 운전자 버전은 연결 중인 MongoDB Server 버전의 모든 새로운 기능 지원 하지 않습니다. 3.8 ~ 3.9 사이의 .NET/C# 드라이버의 모든 버전은 MongoDB Server 9.0과 부분적으로 호환됩니다.

애플리케이션 MongoDB 9.0에서 작동하지 않는 경우, 해당 애플리케이션과 완전히 호환되는(✓) 운전자 버전으로 업그레이드하는 것이 좋습니다. .NET/ C# 운전자 의 경우 여기에는 버전 3.10 이상이 포함됩니다. 완전히 호환되는 운전자 버전을 사용하면 장기적인 안정성이 보장되고 애플리케이션 최신 MongoDB 기능을 사용할 수 있습니다.

각 운전자 버전에 추가되거나 제거된 기능 목록은 드라이버의 출시하다 노트를 참조하세요. 각 MongoDB Server 버전에 추가되거나 제거된 기능 목록은 MongoDB Server 출시 노트를 참조하세요.

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

현재 MongoDB Server 버전이 수명 종료(EOL) 날짜에 도달하여 운전자 버전을 업그레이드하는 경우, MongoDB 버전과 완전히 호환되는(✓) 운전자 버전을 사용하는 것이 좋습니다. 예시 를 들어 MongoDB Server 8.0으로 업그레이드하는 경우 .NET/ C# 운전자 버전 2.29 이상을 사용할 수 있습니다.

그러나 MongoDB Server 9.0으로 업그레이드하는 경우 운전자 버전 3.10 이상으로 업그레이드하는 것이 좋습니다. 이렇게 하면 애플리케이션이 MongoDB Server 9.0 에서 제공되는 모든 기능을 사용할 수 있으며 향후 버전과의 텀 호환성을 제공할 수 있습니다.

내 운전자 버전은 언제 EOL에 도달하나요?

새 운전자 버전은 지난 3년 이내에 EOL에 도달한 모든 MongoDB Server 버전과 완벽하게 호환됩니다. 이 기간이 지나면 새 운전자 버전이 EOL MongoDB Server 버전과 완전히 호환되지 않을 수 있습니다.

예시 들어, MongoDB Server 8.0은 2029년 월부로 EOL되었습니다. 8월 2032 까지의 모든 .NET/C# 드라이버 릴리스는 MongoDB Server 8.0과 완전히 호환됩니다.

장기적인 호환성과 보안을 보장하려면 MongoDB Server 버전이 만료되기 전에 운전자 업그레이드하는 것이 좋습니다. MongoDB Server 출시하다 및 EOL 날짜에 대한 자세한 학습 은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

C# 호환성

이 섹션에서는 .NET/C# 드라이버 버전과 .NET 또는 .NET Framework 버전 간의 호환성을 보여줍니다. 세포에 표시된 체크 표시(✓)는 .NET/C# 드라이버 버전이 .NET 또는 .NET 프레임워크 버전과 완전히 호환됩다는 것을 의미합니다. 빈 세를 조합이 호환되지 않거나 테스트되지 않았다는 의미입니다.

.NET

다음 표는 .NET/ C# 운전자 와 .NET 간의 호환성을 보여줍니다.

.NET/C# 드라이버 버전	.NET 10	.NET 8	.NET 7	.NET 6	.NET 5	.NET Core 3.X	.NET Core 2.X
3.5.2 ~ 3.12	✓	✓	✓	✓	✓	✓
3.0 ~ 3.5.1		✓	✓	✓	✓	✓
2.3 ~ 2.30		✓	✓	✓	✓	✓	✓

.NET Framework

다음 표는 .NET/ C# 운전자 와 .NET Framework 간의 호환성을 보여줍니다.

.NET/C# 드라이버 버전	.NET 4.8	.NET 4.7	.NET 4.6
2.14에서 3.12 [3]	✓	✓
2.0 ~ 2.13	✓	✓	✓

[3]	드라이버 버전 2.14 이상에는 .NET Framework 4.7.2 이상이 필요합니다.

팁

Entity Framework Core Provider를 다운로드하고 첫 번째 애플리케이션을 만드는 방법을 학습하려면 시작하기를 참조하세요.

엔터티 프레임워크 핵심 호환성

MongoDB Entity Framework Core 제공자의 주요 버전은 애플리케이션에서 사용하는 Entity 프레임워크 Core의 주요 버전과 일치해야 합니다. 예시 를 들어 애플리케이션 에서 Entity 프레임워크 Core 8.x를 사용하는 경우 MongoDB Entity 프레임워크 Core 제공자 버전 8.x를 사용해야 합니다.

MongoDB 서버 호환성

Entity Framework Core 제공자에는 MongoDB Server 5.0 이상이 필요합니다.

.NET 호환성

Entity Framework 8.x 및 9.x 제공자를 사용하려면 .NET 8.0 이상이 필요합니다.

Entity 프레임워크 10.x 제공자 사용하려면 .NET 10.0 이상이 필요합니다.

팁

Go 드라이버를 다운로드하고 첫 번째 애플리케이션을 만들는 방법을 학습하려면 시작하기를 참조하세요.

MongoDB 서버 호환성

이 섹션에서는 MongoDB Server 버전과 운전자 버전 간의 호환성에 대해 설명합니다. 다음 표에서는 호환성 수준을 설명합니다.

Icon	설명
✓	모든 기능이 지원됩니다.
⊛	드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
✗	드라이버 버전은 MongoDB 버전에서 작동하지 않습니다. MongoDB 버전에 연결을 시도하면 오류가 발생합니다.
표시 없음	드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

다음 표는 Go 드라이버와 MongoDB Server 간의 호환성을 보여줍니다.

Go 드라이버 버전	MongoDB 9.0	MongoDB 8.0	MongoDB 7.0	MongoDB 6.1	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2
2.9	✓	✓	✓	✓	✓	✓	✓
2.6 ~ 2.8	⊛	✓	✓	✓	✓	✓	✓	✓
2.1 ~ 2.5		✓	✓	✓	✓	✓	✓	✓
1.12 ~ 2.0		⊛ [4]	✓	✓	✓	✓	✓	✓
1.11		⊛	⊛	✓	✓	✓	✓	✓

[4]	고 (Go) 운전자 v1.17 및 v2.0 는 MongoDB Server 8.0 와 부분적으로 호환되지만 클라이언트 대량 쓰기 (write) 지원 하지 않습니다.

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

애플리케이션 현재 지원되는 MongoDB 버전에서 작동하는 경우 9.0에서도 작동해야 하지만, 비프로덕션 환경에서 테스트할 것을 적극 권장합니다. 부분적으로 호환되는 운전자 버전은 연결 중인 MongoDB Server 버전의 모든 새로운 기능 지원 하지 않습니다. 2.6 와 2.8 사이의 모든 버전의 Go 드라이버는 MongoDB Server 9.0과 부분적으로 호환됩니다.

애플리케이션 MongoDB 9.0에서 작동하지 않는 경우, 해당 애플리케이션과 완전히 호환되는(✓) 드라이버 버전으로 업그레이드하는 것이 좋습니다. 고 (Go) 운전자 의 경우 여기에는 버전 2.9 이상이 포함됩니다. 완전히 호환되는 드라이버 버전을 사용하면 장기적인 안정성이 보장되고 애플리케이션이 최신 MongoDB 기능을 사용할 수 있습니다.

각 운전자 버전에 추가되거나 제거된 기능 목록은 드라이버의 출시하다 노트를 참조하세요. 각 MongoDB Server 버전에 추가되거나 제거된 기능 목록은 MongoDB Server 출시 노트를 참조하세요.

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

현재 MongoDB Server 버전이 수명 종료(EOL) 날짜에 도달하여 드라이버 버전을 업그레이드하는 경우, MongoDB 버전과 완전히 호환되는(✓) 드라이버 버전을 사용하는 것이 좋습니다. 예시를 들어 MongoDB Server 8.0으로 업그레이드하는 경우 Go 드라이버 버전 2.1 이상을 사용할 수 있습니다.

그러나 MongoDB Server 9.0으로 업그레이드하는 경우 운전자 버전 2.9 이상으로 업그레이드하는 것이 좋습니다. 이렇게 하면 애플리케이션이 MongoDB Server 9.0 에서 제공되는 모든 기능을 사용할 수 있으며 향후 버전과의 텀 호환성을 제공할 수 있습니다.

내 운전자 버전은 언제 EOL에 도달하나요?

새 운전자 버전은 지난 3년 이내에 EOL에 도달한 모든 MongoDB Server 버전과 완벽하게 호환됩니다. 이 기간이 지나면 새 운전자 버전이 EOL MongoDB Server 버전과 완전히 호환되지 않을 수 있습니다.

예시 들어, MongoDB Server 8.0은 2029년 월부로 EOL되었습니다. 8월 2032 까지의 모든 Go 드라이버 릴리스는 MongoDB Server 8.0과 완전히 호환됩니다.

장기적인 호환성과 보안을 보장하려면 MongoDB Server 버전이 만료되기 전에 운전자 업그레이드하는 것이 좋습니다. MongoDB Server 출시하다 및 EOL 날짜에 대한 자세한 학습 은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

고 (Go) 호환성

고 (Go) 운전자 고 (Go) 1.25 이상이 필요합니다.

팁

Java Sync Driver를 다운로드하고 첫 번째 애플리케이션을 만드는 방법을 학습하려면 시작하기를 참조하세요.

MongoDB 서버 호환성

이 섹션에서는 MongoDB Server 버전과 운전자 버전 간의 호환성에 대해 설명합니다. 다음 표에서는 호환성 수준을 설명합니다.

Icon	설명
✓	모든 기능이 지원됩니다.
⊛	드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
✗	드라이버 버전은 MongoDB 버전에서 작동하지 않습니다. MongoDB 버전에 연결을 시도하면 오류가 발생합니다.
표시 없음	드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

다음 표는 Java 드라이버와 MongoDB Server 간의 호환성을 보여줍니다.

Java 드라이버 버전	MongoDB 9.0	MongoDB 8.3	MongoDB 8.1 ~ 8.2	MongoDB 8.0	MongoDB 7.0	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2
5.12 ~ 5.13	✓	✓	✓	✓	✓	✓	✓	✓	✓
5.9 ~ 5.11	⊛	✓	✓	✓	✓	✓	✓	✓	✓
5.8		✓	✓	✓	✓	✓	✓	✓	✓
5.2 ~ 5.7		⊛	✓	✓	✓	✓	✓	✓	✓
4.10 ~ 5.1		⊛	⊛	⊛	✓	✓	✓	✓	✓
4.8 ~ 4.9		⊛	⊛	⊛	⊛	✓	✓	✓	✓
4.7		⊛	⊛	⊛	⊛	✓	✓	✓	✓
4.3 ~ 4.6		⊛	⊛	⊛	⊛	⊛	✓	✓	✓
4.1 ~ 4.2		⊛	⊛	⊛	⊛	⊛	⊛	✓	✓
4.0		⊛	⊛	⊛	⊛	⊛	⊛	⊛	⊛
3.11 ~ 3.12		✗ [5]	✗ [5]	⊛	⊛	⊛	⊛	⊛	⊛
3.8 ~ 3.10		✗ [5]	✗ [5]	⊛	⊛	⊛	⊛	⊛	⊛

[5]	(1, 2, 3, 4) 이러한 운전자 버전은 인증 문제로 인해 MongoDB 8.1 이상과 호환되지 않습니다. 자세한 학습 은 드라이버 버전 업그레이드를 참조하세요.

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

애플리케이션 현재 지원되는 MongoDB 버전에서 작동하는 경우 9.0에서도 작동해야 하지만, 비프로덕션 환경에서 테스트할 것을 적극 권장합니다. 부분적으로 호환되는 운전자 버전은 연결 중인 MongoDB Server 버전의 모든 새로운 기능 지원 하지 않습니다. 5.9 ~ 5.11 사이의 모든 버전의 Java 드라이버는 MongoDB Server 9.0과 부분적으로 호환됩니다.

애플리케이션 MongoDB 9.0에서 작동하지 않는 경우, 해당 애플리케이션과 완전히 호환되는(✓) 드라이버 버전으로 업그레이드하는 것이 좋습니다. Java 드라이버의 경우 여기에는 버전 5.12 이상이 포함됩니다. 완전히 호환되는 드라이버 버전을 사용하면 장기적인 안정성이 보장되고 애플리케이션이 최신 MongoDB 기능을 사용할 수 있습니다.

각 운전자 버전에 추가되거나 제거된 기능 목록은 드라이버의 출시하다 노트를 참조하세요. 각 MongoDB Server 버전에 추가되거나 제거된 기능 목록은 MongoDB Server 출시 노트를 참조하세요.

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

현재 MongoDB Server 버전이 수명 종료(EOL) 날짜에 도달하여 드라이버 버전을 업그레이드하는 경우, MongoDB 버전과 완전히 호환되는(✓) 드라이버 버전을 사용하는 것이 좋습니다. 예시를 들어 MongoDB Server 8.0으로 업그레이드하는 경우 Java 드라이버 버전 5.2 이상을 사용할 수 있습니다.

그러나 MongoDB Server 9.0으로 업그레이드하는 경우 운전자 버전 5.12 이상으로 업그레이드하는 것이 좋습니다. 이렇게 하면 애플리케이션이 MongoDB Server 9.0 에서 제공되는 모든 기능을 사용할 수 있으며 향후 버전과의 텀 호환성을 제공할 수 있습니다.

내 운전자 버전은 언제 EOL에 도달하나요?

새 운전자 버전은 지난 3년 이내에 EOL에 도달한 모든 MongoDB Server 버전과 완벽하게 호환됩니다. 이 기간이 지나면 새 운전자 버전이 EOL MongoDB Server 버전과 완전히 호환되지 않을 수 있습니다.

예시 들어, MongoDB Server 8.0은 2029년 월부로 EOL되었습니다. 8월 2032 까지의 모든 Java 드라이버 릴리스 MongoDB Server 8.0과 완전히 호환됩니다.

장기적인 호환성과 보안을 보장하려면 MongoDB Server 버전이 만료되기 전에 운전자 업그레이드하는 것이 좋습니다. MongoDB Server 출시하다 및 EOL 날짜에 대한 자세한 학습 은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

Java 호환성

이 섹션에서는 Java 드라이버 버전과 Java 버전 간의 호환성을 볼 수 있습니다. 세를 표시하는 체크 표시(✓)는 Java 드라이버 버전이 Java 버전과 완전히 호환되는 경우를 의미합니다. 빈 세를 조합이 호환되지 않거나 테스트되지 않았다는 의미입니다.

Java 8부터 이 표에는 LTS(Long-Term Support) Java 버전만 나열됩니다. 드라이버는 JVM(Java Virtual Machine) 하위 호환성을 통해 Java 8 이후 모든 버전을 지원합니다.

Java 드라이버 버전	Java 21	Java 17	Java 11	Java 8	Java 7	Java 6
4.11 ~ 5.13	✓	✓	✓	✓
4.5 ~ 4.10	✓ [6]	✓	✓	✓
4.4		✓	✓	✓
4.0 ~ 4.3			✓	✓
3.8 ~ 3.12			✓	✓	✓	✓

[6]	이 드라이버 버전은 가상 스레드와 호환되지 않습니다.

팁

Java Reactive Streams 드라이버를 다운로드하고 첫 번째 애플리케이션을 만드는 방법을 익히려면 시작하기를 참조하세요.

MongoDB 서버 호환성

이 섹션에서는 MongoDB Server 버전과 운전자 버전 간의 호환성에 대해 설명합니다. 다음 표에서는 호환성 수준을 설명합니다.

Icon	설명
✓	모든 기능이 지원됩니다.
⊛	드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
✗	드라이버 버전은 MongoDB 버전에서 작동하지 않습니다. MongoDB 버전에 연결을 시도하면 오류가 발생합니다.
표시 없음	드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

다음 표는 Java Reactive Streams 드라이버와 MongoDB Server 간의 호환성을 보여줍니다.

Java Reactive Streams 드라이버 버전	MongoDB 9.0	MongoDB 8.3	MongoDB 8.1 ~ 8.2	MongoDB 8.0	MongoDB 7.0	MongoDB 6.0
5.12 ~ 5.13	✓	✓	✓	✓	✓	✓
5.9 ~ 5.11	⊛	✓	✓	✓	✓	✓
5.8		✓	✓	✓	✓	✓
5.2 ~ 5.7		⊛	✓	✓	✓	✓
4.10 ~ 5.1		⊛	⊛	⊛	✓	✓
4.7 ~ 4.9		⊛	⊛	⊛	⊛	✓
4.0 ~ 4.6		⊛	⊛	⊛	⊛	⊛
3.11 ~ 3.12		✗ [7]	✗ [7]	⊛	⊛	⊛

[ 7 ]

(1, 2) 이러한 운전자 버전은 인증 문제로 인해 MongoDB 8.1 이상과 호환되지 않습니다. 자세한 학습 은 드라이버 버전 업그레이드를 참조하세요.

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

애플리케이션 현재 지원되는 MongoDB 버전에서 작동하는 경우 9.0에서도 작동해야 하지만, 비프로덕션 환경에서 테스트할 것을 적극 권장합니다. 부분적으로 호환되는 운전자 버전은 연결 중인 MongoDB Server 버전의 모든 새로운 기능 지원 하지 않습니다. 5.9 ~ 5.11 사이의 모든 버전의 Java Reactive Streams 드라이버는 MongoDB Server 9.0과 부분적으로 호환됩니다.

애플리케이션 MongoDB 9.0에서 작동하지 않는 경우, 해당 애플리케이션과 완전히 호환되는(✓) 드라이버 버전으로 업그레이드하는 것이 좋습니다. Java Reactive Streams 드라이버의 경우 여기에는 버전 5.12 이상이 포함됩니다. 완전히 호환되는 드라이버 버전을 사용하면 장기적인 안정성이 보장되고 애플리케이션이 최신 MongoDB 기능을 사용할 수 있습니다.

각 운전자 버전에 추가되거나 제거된 기능 목록은 드라이버의 출시하다 노트를 참조하세요. 각 MongoDB Server 버전에 추가되거나 제거된 기능 목록은 MongoDB Server 출시 노트를 참조하세요.

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

현재 MongoDB Server 버전이 수명 종료(EOL) 날짜에 도달하여 드라이버 버전을 업그레이드하는 경우, MongoDB 버전과 완전히 호환되는(✓) 드라이버 버전을 사용하는 것이 좋습니다. 예시를 들어 MongoDB Server 8.0으로 업그레이드하는 경우 Java Reactive Streams 드라이버 버전 5.2 이상을 사용할 수 있습니다.

그러나 MongoDB Server 9.0으로 업그레이드하는 경우 운전자 버전 5.12 이상으로 업그레이드하는 것이 좋습니다. 이렇게 하면 애플리케이션이 MongoDB Server 9.0 에서 제공되는 모든 기능을 사용할 수 있으며 향후 버전과의 텀 호환성을 제공할 수 있습니다.

내 운전자 버전은 언제 EOL에 도달하나요?

새 운전자 버전은 지난 3년 이내에 EOL에 도달한 모든 MongoDB Server 버전과 완벽하게 호환됩니다. 이 기간이 지나면 새 운전자 버전이 EOL MongoDB Server 버전과 완전히 호환되지 않을 수 있습니다.

예시 들어, MongoDB Server 8.0은 2029년 월부로 EOL되었습니다. 8월 2032 까지의 모든 Java Reactive Streams 드라이버 릴리스는 MongoDB Server 8.0과 완전히 호환됩니다.

장기적인 호환성과 보안을 보장하려면 MongoDB Server 버전이 만료되기 전에 운전자 업그레이드하는 것이 좋습니다. MongoDB Server 출시하다 및 EOL 날짜에 대한 자세한 학습 은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

Java 호환성

이 섹션에서는 Java Reactive Streams 드라이버 버전과 Java 버전 간의 호환성을 보여줍니다. 세를 표시하는 체크표(✓)는 Java Reactive Streams 드라이버 버전이 Java 버전과 완전히 호환된다는 의미입니다. 빈 세를 조합이 호환되지 않거나 테스트되지 않았다는 의미입니다.

Java 8부터 이 표에는 LTS(Long-Term Support) Java 버전만 나열됩니다. 드라이버는 JVM(Java Virtual Machine) 하위 호환성을 통해 Java 8 이후 모든 버전을 지원합니다.

Java Reactive Streams 드라이버 버전	Java 21	Java 17	Java 11	Java 8	Java 7	Java 6
4.11 ~ 5.13	✓	✓	✓	✓
4.5 ~ 4.10	✓ [8]	✓	✓	✓
4.4		✓	✓	✓
4.1 ~ 4.3			✓	✓	✓	✓

[8]	이 드라이버 버전은 가상 스레드와 호환되지 않습니다.

팁

Hibernate ORM을 위한 MongoDB 확장을 다운로드하고 첫 번째 애플리케이션을 만드는 방법을 학습하려면 시작하기를 참조하세요.

최대 절전 모드 호환성

최대 절전 모드 ORM용 MongoDB 확장에는 최대 절전 모드 ORM 6.6 이전 버전이 필요합니다.

MongoDB 서버 호환성

최대 절전 모드 ORM용 MongoDB 확장에는 MongoDB Server 7.0 이상이 필요합니다.

Java 호환성

최대 절전 모드 ORM용 MongoDB 확장에는 Java 17 이상이 필요합니다.

Java 드라이버 호환성

최대 절전 모드 ORM용 MongoDB 확장에는 MongoDB Java 드라이버 5.5 이상이 필요합니다.

팁

Spring Session MongoDB 시작하는 방법과 첫 번째 애플리케이션 생성에 대해 학습하려면 시작하기를 참조하세요.

Spring 에코시스템 호환성

Spring Session MongoDB 다음 Spring 제품과 호환됩니다.

스프링 세션 4.0 이상
Spring 프레임워크 7.0 이상
Spring Boot 4.0 이상
Spring Data 2025.1 이상

MongoDB 서버 호환성

Spring Session MongoDB MongoDB Server 4.2 이상이 필요합니다.

Java 호환성

Spring Session MongoDB Java 17 이상이 필요합니다.

Java 드라이버 호환성

Spring Session MongoDB MongoDB Java 드라이버 5.6.1 이상이 필요합니다.

팁

Kotlin 동기화 드라이버를 다운로드하고 첫 번째 애플리케이션을 생성하는 방법을 학습하려면 시작하기를 참조하세요.

MongoDB 서버 호환성

이 섹션에서는 MongoDB Server 버전과 운전자 버전 간의 호환성에 대해 설명합니다. 다음 표에서는 호환성 수준을 설명합니다.

Icon	설명
✓	모든 기능이 지원됩니다.
⊛	드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
✗	드라이버 버전은 MongoDB 버전에서 작동하지 않습니다. MongoDB 버전에 연결을 시도하면 오류가 발생합니다.
표시 없음	드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

다음 표는 코틀린 (Kotlin) 드라이버와 MongoDB Server 간의 호환성을 보여줍니다.

코틀린 드라이버 버전	MongoDB 9.0	MongoDB 8.3	MongoDB 8.1 ~ 8.2	MongoDB 8.0	MongoDB 7.0	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2
5.12 ~ 5.13	✓	✓	✓	✓	✓	✓	✓	✓	✓
5.9 ~ 5.11	⊛	✓	✓	✓	✓	✓	✓	✓	✓
5.8		✓	✓	✓	✓	✓	✓	✓	✓
5.2 ~ 5.7		⊛	✓	✓	✓	✓	✓	✓	✓
4.10 ~ 5.1		⊛	⊛	⊛	✓	✓	✓	✓	✓

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

애플리케이션이 현재 지원되는 MongoDB 버전에서 작동하는 경우 9.0에서도 작동해야 하지만 비생산 환경에서 테스트하는 것을 강력히 권장합니다. 부분적으로 호환되는 드라이버 버전은 연결하는 MongoDB Server 버전의 모든 새 기능을 지원하지 않습니다. 5.9 과 5.11 사이의 모든 Kotlin 동기화 드라이버 버전은 MongoDB Server 9.0과 부분적으로 호환됩니다.

애플리케이션이 MongoDB 9.0과 함께 작동하지 않는 경우 완전히 호환되는(✓) 드라이버 버전으로 업그레이드하는 것이 좋습니다. Kotlin 동기화 드라이버의 경우 버전 5.12 이상이 포함됩니다. 완전히 호환되는 드라이버 버전을 사용하면 장기적인 안정성이 보장되고 애플리케이션이 최신 MongoDB 기능을 사용할 수 있습니다.

각 운전자 버전에 추가되거나 제거된 기능 목록은 드라이버의 출시하다 노트를 참조하세요. 각 MongoDB Server 버전에 추가되거나 제거된 기능 목록은 MongoDB Server 출시 노트를 참조하세요.

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

현재 MongoDB Server 버전이 수명 종료(EOL) 날짜에 도달하여 드라이버 버전을 업그레이드하는 경우, MongoDB 버전과 완전히 호환되는(✓) 드라이버 버전을 사용하는 것이 좋습니다. 예시를 들어 MongoDB Server 8.0으로 업그레이드하는 경우 Kotlin 동기화 드라이버 버전 5.2 이상을 사용할 수 있습니다.

그러나 MongoDB Server 9.0으로 업그레이드하는 경우 운전자 버전 5.12 이상으로 업그레이드하는 것이 좋습니다. 이렇게 하면 애플리케이션이 MongoDB Server 9.0 에서 제공되는 모든 기능을 사용할 수 있으며 향후 버전과의 텀 호환성을 제공할 수 있습니다.

내 운전자 버전은 언제 EOL에 도달하나요?

새 운전자 버전은 지난 3년 이내에 EOL에 도달한 모든 MongoDB Server 버전과 완벽하게 호환됩니다. 이 기간이 지나면 새 운전자 버전이 EOL MongoDB Server 버전과 완전히 호환되지 않을 수 있습니다.

예시 들어, MongoDB Server 8.0은 2029년 월부로 EOL되었습니다. 8월 2032 까지의 모든 Kotlin 동기화 드라이버 릴리스는 MongoDB Server 8.0과 완전히 호환됩니다.

장기적인 호환성과 보안을 보장하려면 MongoDB Server 버전이 만료되기 전에 운전자 업그레이드하는 것이 좋습니다. MongoDB Server 출시하다 및 EOL 날짜에 대한 자세한 학습 은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

코틀린 (Kotlin) 호환성

코틀린 (Kotlin) 운전자 코틀린 (Kotlin) 1.8 이상이 필요합니다.

팁

Kotlin 코루틴 드라이버를 다운로드하고 첫 번째 애플리케이션을 만들는 방법을 학습하려면 시작하기를 참조하세요.

MongoDB 서버 호환성

이 섹션에서는 MongoDB Server 버전과 운전자 버전 간의 호환성에 대해 설명합니다. 다음 표에서는 호환성 수준을 설명합니다.

Icon	설명
✓	모든 기능이 지원됩니다.
⊛	드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
✗	드라이버 버전은 MongoDB 버전에서 작동하지 않습니다. MongoDB 버전에 연결을 시도하면 오류가 발생합니다.
표시 없음	드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

다음 표는 Kotlin 코루틴 드라이버와 MongoDB Server 간의 호환성을 보여줍니다.

코틀린 드라이버 버전	MongoDB 9.0	MongoDB 8.3	MongoDB 8.1 ~ 8.2	MongoDB 8.0	MongoDB 7.0	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2
5.12 ~ 5.13	✓	✓	✓	✓	✓	✓	✓	✓	✓
5.9 ~ 5.11	⊛	✓	✓	✓	✓	✓	✓	✓	✓
5.8		✓	✓	✓	✓	✓	✓	✓	✓
5.2 ~ 5.7		⊛	✓	✓	✓	✓	✓	✓	✓
4.10 ~ 5.1		⊛	⊛	⊛	✓	✓	✓	✓	✓

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

애플리케이션 현재 지원되는 MongoDB 버전에서 작동하는 경우 9.0에서도 작동해야 하지만, 비프로덕션 환경에서 테스트할 것을 적극 권장합니다. 부분적으로 호환되는 운전자 버전은 연결 중인 MongoDB Server 버전의 모든 새로운 기능 지원 하지 않습니다. 5.9 ~ 5.11 사이의 모든 버전의 Kotlin 코루틴 드라이버는 MongoDB Server 9.0과 부분적으로 호환됩니다.

애플리케이션 MongoDB 9.0에서 작동하지 않는 경우, 해당 애플리케이션과 완전히 호환되는(✓) 드라이버 버전으로 업그레이드하는 것이 좋습니다. 코틀린 (Kotlin) 코루틴 드라이버의 경우 5.12 버전 이상이 포함됩니다. 완전히 호환되는 드라이버 버전을 사용하면 장기적인 안정성이 보장되고 애플리케이션이 최신 MongoDB 기능을 사용할 수 있습니다.

각 운전자 버전에 추가되거나 제거된 기능 목록은 드라이버의 출시하다 노트를 참조하세요. 각 MongoDB Server 버전에 추가되거나 제거된 기능 목록은 MongoDB Server 출시 노트를 참조하세요.

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

현재 MongoDB Server 버전이 수명 종료(EOL) 날짜에 도달하여 드라이버 버전을 업그레이드하는 경우, MongoDB 버전과 완전히 호환되는(✓) 드라이버 버전을 사용하는 것이 좋습니다. 예시를 들어 MongoDB Server 8.0으로 업그레이드하는 경우 Kotlin 코루틴 드라이버 버전 5.2 이상을 사용할 수 있습니다.

그러나 MongoDB Server 9.0으로 업그레이드하는 경우 운전자 버전 5.12 이상으로 업그레이드하는 것이 좋습니다. 이렇게 하면 애플리케이션이 MongoDB Server 9.0 에서 제공되는 모든 기능을 사용할 수 있으며 향후 버전과의 텀 호환성을 제공할 수 있습니다.

내 운전자 버전은 언제 EOL에 도달하나요?

새 운전자 버전은 지난 3년 이내에 EOL에 도달한 모든 MongoDB Server 버전과 완벽하게 호환됩니다. 이 기간이 지나면 새 운전자 버전이 EOL MongoDB Server 버전과 완전히 호환되지 않을 수 있습니다.

예시 들어, MongoDB Server 8.0은 2029년 월부로 EOL되었습니다. 8월 2032 까지의 모든 Kotlin 코루틴 드라이버 릴리스는 MongoDB Server 8.0과 완전히 호환됩니다.

장기적인 호환성과 보안을 보장하려면 MongoDB Server 버전이 만료되기 전에 운전자 업그레이드하는 것이 좋습니다. MongoDB Server 출시하다 및 EOL 날짜에 대한 자세한 학습 은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

코틀린 (Kotlin) 호환성

코틀린 (Kotlin) 코루틴 운전자 코틀린 (Kotlin) 1.8 이상이 필요합니다.

팁

Node.js 드라이버를 다운로드하고 첫 번째 애플리케이션을 만드는 방법을 학습하려면 시작하기를 참조하세요.

MongoDB 서버 호환성

이 섹션에서는 MongoDB Server 버전과 운전자 버전 간의 호환성에 대해 설명합니다. 다음 표에서는 호환성 수준을 설명합니다.

Icon	설명
✓	모든 기능이 지원됩니다.
⊛	드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
✗	드라이버 버전은 MongoDB 버전에서 작동하지 않습니다. MongoDB 버전에 연결을 시도하면 오류가 발생합니다.
표시 없음	드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

다음 표는 Node.js 운전자 와 MongoDB Server 간의 호환성을 보여줍니다.

Node.js 드라이버 버전	MongoDB 9.0	MongoDB 8.0	MongoDB 7.0	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2
7.6 ~ 7.7	✓	✓	✓	✓	✓	✓
7.3 ~ 7.5	⊛	✓	✓	✓	✓	✓	✓
6.9 ~ 7.2		✓	✓	✓	✓	✓	✓
5.7 ~ 6.8		⊛	✓	✓	✓	✓	✓
5.0 ~ 5.6		⊛	⊛	✓	✓	✓	✓
4.8~4.17			⊛	✓	✓	✓	✓
4.0 ~ 4.7			⊛	⊛	✓	✓	✓
3.7 [9]				⊛	✓	✓	✓
3.6				⊛	⊛	✓	✓

[9]	Node.js 드라이버 버전 3.7을 사용하는 경우 특정 기능에 대해 `useUnifiedTopology` 플래그를 `true`로 설정해야 합니다.

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

애플리케이션 현재 지원되는 MongoDB 버전에서 작동하는 경우 9.0에서도 작동해야 하지만, 비프로덕션 환경에서 테스트할 것을 적극 권장합니다. 부분적으로 호환되는 운전자 버전은 연결 중인 MongoDB Server 버전의 모든 새로운 기능 지원 하지 않습니다. 7.3 에서 7.5 사이의 노드.js 드라이버 모든 버전은 MongoDB Server 9.0과 부분적으로 호환됩니다.

애플리케이션 MongoDB 9.0에서 작동하지 않는 경우, 해당 애플리케이션과 완전히 호환되는(✓) 운전자 버전으로 업그레이드하는 것이 좋습니다. Node.js 운전자 의 경우 여기에는 버전 7.6 이상이 포함됩니다. 완전히 호환되는 운전자 버전을 사용하면 장기적인 안정성이 보장되고 애플리케이션 최신 MongoDB 기능을 사용할 수 있습니다.

각 운전자 버전에 추가되거나 제거된 기능 목록은 드라이버의 출시하다 노트를 참조하세요. 각 MongoDB Server 버전에 추가되거나 제거된 기능 목록은 MongoDB Server 출시 노트를 참조하세요.

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

현재 MongoDB Server 버전이 수명 종료(EOL) 날짜에 도달하여 운전자 버전을 업그레이드하는 경우, MongoDB 버전과 완전히 호환되는(✓) 운전자 버전을 사용하는 것이 좋습니다. 예시 들어 MongoDB Server 8.0으로 업그레이드하는 경우 Node.js 운전자 버전 6.9 이상을 사용할 수 있습니다.

그러나 MongoDB Server 9.0으로 업그레이드하는 경우 운전자 버전 7.6 이상으로 업그레이드하는 것이 좋습니다. 이렇게 하면 애플리케이션이 MongoDB Server 9.0 에서 제공되는 모든 기능을 사용할 수 있으며 향후 버전과의 텀 호환성을 제공할 수 있습니다.

내 운전자 버전은 언제 EOL에 도달하나요?

새 운전자 버전은 지난 3년 이내에 EOL에 도달한 모든 MongoDB Server 버전과 완벽하게 호환됩니다. 이 기간이 지나면 새 운전자 버전이 EOL MongoDB Server 버전과 완전히 호환되지 않을 수 있습니다.

예시 들어, MongoDB Server 8.0은 2029년 월부로 EOL되었습니다. 8월 2032 까지 모든 Node.js 드라이버 릴리스 MongoDB Server 8.0과 완전히 호환됩니다.

장기적인 호환성과 보안을 보장하려면 MongoDB Server 버전이 만료되기 전에 운전자 업그레이드하는 것이 좋습니다. MongoDB Server 출시하다 및 EOL 날짜에 대한 자세한 학습 은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

노드.js 호환성

이 섹션에서는 Node.js 드라이버 버전과 Node.js 버전 간의 호환성을 볼 수 있습니다. 세를 표시하는 체크 표(✓)는 Node.js 드라이버 버전이 Node.js 버전과 완전히 호환되는 경우를 의미합니다. 빈 세를 조합이 호환되지 않거나 테스트되지 않았다는 의미입니다.

다음 표는 노드.js 드라이버와 노드.js 간의 호환성을 보여줍니다.

Node.js 드라이버 버전	Node.js v24.x.x	Node.js v22.x.x	Node.js v20.x.x	Node.js v18.x.x	Node.js v16.x.x	Node.js v14.x.x	Node.js v12.x.x	Node.js v10.x.x	Node.js v8.x.x	Node.js v6.x.x	Node.js v4.x.x
7.0에서 7.7 [10]	✓	✓	✓
6.11에서 6.21 [11]		✓	✓	✓	✓
6.0에서 6.10 [11]			✓	✓	✓
5.6.x ~ 5.9.x			✓	✓	✓	✓
5.0.0 ~ 5.5.x				✓	✓	✓
4.x				✓	✓	✓	✓
3.x						✓	✓	✓	✓	✓	✓

[10]	Node.js 드라이버 버전 7.x에는 Node.js v20.19.0 이상이 필요합니다.

[ 11 ]

(1, 2) Node.js 운전자 의 6.x 버전에는 Node.js v16.20.1 이상이 필요합니다.

컴포넌트 호환성

다음 표에서는 Node.js 드라이버에 대한 추가 구성 요소 버전 호환성에 대해 설명합니다. 이 표에서는 캐릿 범위 (^)를 사용하여 호환 버전을 표시합니다. 세를 비우면 드라이버 버전이 구성 요소와 호환되지 않습니다.

Node.js 드라이버 버전	BSON	bson-ext [12]	@mongodb-js/kerberos	MongoDB-클라이언트-암호화	@mongodb-js/zstd	@aws-sdk/credential-providers	gcp-metadata	양말
7.x	^7.0.0		^7.0.0	^7.0.0	^7.0.0	^3.806.0	^7.0.1	^2.8.6
6.x	^6.0.0		^2.0.1	^6.0.0	^1.1.0
5.x	^5.0.0		1.0.0 또는 ^2.0.0	^2.3.0	^1.0.0
4.x	^4.0.0	^4.0.0	1.0.0 또는 ^2.0.0	1.0.0 또는 ^2.0.0	^1.0.0
3.x	^1.0.0	1.0.0 또는 ^2.0.0	^1.0.0	^1.0.0

[12]	드라이버 버전 5.x 및 이후에서는 `bson-ext`을 지원하지 않습니다. 대신 `bson` 를 사용하세요.

팁

PHP 라이브러리를 다운로드하고 첫 번째 애플리케이션을 만들는 방법을 학습하려면 시작하기를 참조하세요.

MongoDB 서버 호환성

이 섹션에서는 MongoDB Server 버전과 운전자 버전 간의 호환성에 대해 설명합니다. 다음 표에서는 호환성 수준을 설명합니다.

Icon	설명
✓	모든 기능이 지원됩니다.
⊛	드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
✗	드라이버 버전은 MongoDB 버전에서 작동하지 않습니다. MongoDB 버전에 연결을 시도하면 오류가 발생합니다.
표시 없음	드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

다음 표는 PHP 드라이버와 MongoDB Server 간의 호환성을 보여줍니다.

PHP 드라이버 버전	MongoDB 9.0	MongoDB 8.0	MongoDB 7.0	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2
ext + lib 2.5	✓	✓	✓	✓	✓	✓	✓
ext + lib 2.4	⊛	✓	✓	✓	✓	✓	✓
ext + lib 2.3	⊛	✓	✓	✓	✓	✓	✓
ext + lib 1.20 ~ 2.2		✓	✓	✓	✓	✓	✓
ext + lib 1.16 ~ 1.19		⊛	✓	✓	✓	✓	✓
ext + lib 1.15		⊛	⊛	✓	✓	✓	✓

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

애플리케이션 현재 지원되는 MongoDB 버전에서 작동하는 경우 9.0에서도 작동해야 하지만, 비프로덕션 환경에서 테스트할 것을 적극 권장합니다. 부분적으로 호환되는 운전자 버전은 연결 중인 MongoDB Server 버전의 모든 새로운 기능 지원 하지 않습니다. 2.3 와 2.4 사이의 모든 버전의 PHP 라이브러리는 MongoDB Server 9.0과 부분적으로 호환됩니다.

애플리케이션 MongoDB 9.0에서 작동하지 않는 경우, 해당 애플리케이션과 완전히 호환되는(✓) 드라이버 버전으로 업그레이드하는 것이 좋습니다. PHP 라이브러리의 경우 여기에는 버전 2.5 이상이 포함됩니다. 완전히 호환되는 드라이버 버전을 사용하면 장기적인 안정성이 보장되고 애플리케이션이 최신 MongoDB 기능을 사용할 수 있습니다.

각 운전자 버전에 추가되거나 제거된 기능 목록은 드라이버의 출시하다 노트를 참조하세요. 각 MongoDB Server 버전에 추가되거나 제거된 기능 목록은 MongoDB Server 출시 노트를 참조하세요.

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

현재 MongoDB Server 버전이 수명 종료(EOL) 날짜에 도달하여 드라이버 버전을 업그레이드하는 경우, MongoDB 버전과 완전히 호환되는(✓) 드라이버 버전을 사용하는 것이 좋습니다. 예시 를 들어 MongoDB Server 8.0으로 업그레이드하는 경우 PHP 라이브러리 버전 1.20 이상을 사용할 수 있습니다.

그러나 MongoDB Server 9.0으로 업그레이드하는 경우 운전자 버전 2.5 이상으로 업그레이드하는 것이 좋습니다. 이렇게 하면 애플리케이션이 MongoDB Server 9.0 에서 제공되는 모든 기능을 사용할 수 있으며 향후 버전과의 텀 호환성을 제공할 수 있습니다.

내 운전자 버전은 언제 EOL에 도달하나요?

새 운전자 버전은 지난 3년 이내에 EOL에 도달한 모든 MongoDB Server 버전과 완벽하게 호환됩니다. 이 기간이 지나면 새 운전자 버전이 EOL MongoDB Server 버전과 완전히 호환되지 않을 수 있습니다.

예시 들어, MongoDB Server 8.0은 2029년 월부로 EOL되었습니다. 8월 2032 까지의 모든 PHP 라이브러리 릴리스는 MongoDB Server 8.0과 완전히 호환됩니다.

장기적인 호환성과 보안을 보장하려면 MongoDB Server 버전이 만료되기 전에 운전자 업그레이드하는 것이 좋습니다. MongoDB Server 출시하다 및 EOL 날짜에 대한 자세한 학습 은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

PHP 호환성

이 섹션에서는 PHP 라이브러리 버전과 PHP 버전 간의 호환성을 표시합니다. 세를 표시하는 확인 표시(✓)는 PHP 라이브러리 버전이 PHP 버전과 완전히 호환되다는 의미입니다. 빈 세를 조합이 호환되지 않거나 테스트되지 않았다는 의미입니다.

다음 표는 PHP 드라이버와 PHP 간의 호환성을 보여줍니다.

PHP 드라이버 버전	PHP 8.5	PHP 8.4	PHP 8.3	PHP 8.2	PHP 8.1	PHP 8.0	PHP 7.4	PHP 7.3	PHP 7.2
ext + lib 2.1 ~ 2.5	✓	✓	✓	✓	✓
ext + lib 1.21 ~ 2.0		✓	✓	✓	✓
ext + lib 1.20		✓	✓	✓	✓	✓	✓
ext + lib 1.17 ~ 1.19		✓	✓	✓	✓	✓	✓
ext + lib 1.16			✓	✓	✓	✓	✓	✓	✓
ext + lib 1.15			✓	✓	✓	✓	✓	✓	✓

참고

32비트 환경

64비트 환경에서는 PHP 드라이버를 사용하는 것이 좋습니다. 32비트 환경에서 드라이버는 데이터베이스 의 64비트 정수를 PHP 정수가 아닌 MongoDB\BSON\Int64 클래스의 인스턴스로 반환합니다.

PHP 확장 호환성

MongoDB PHP 드라이버 두 가지 구성 요소로 구성됩니다.

MongoDB PHP 확장: 핵심 드라이버 기능을 위한 최소한의 API
MongoDB PHP 라이브러리: 클라이언트, 데이터베이스 및 컬렉션 객체에 대한 추상화를 포함하고 데이터베이스 작업 메서드를 제공하는 고급 API 입니다.

PHP 드라이버 사용하려면 두 구성 요소를 모두 설치해야 합니다. 다음 표는 각 PHP 라이브러리 버전에 대해 지원되는 최소 PHP 확장 버전을 보여줍니다.

PHP 라이브러리 버전	최소 PHP 확장 버전
2.5	2.5
2.4	2.4
2.3	2.3
2.2	2.2
2.1	2.1
2.0	2.0
1.21	1.21
1.20	1.20
1.19	1.19
1.18	1.18
1.17	1.17
1.16	1.15
1.15	1.15
1.14	1.14
1.13	1.12
1.12	1.12
1.11	1.11
1.10	1.10

팁

새로운 기능에는 두 구성 요소에 대한 업데이트가 포함되어 있으므로 대부분의 PHP 라이브러리 버전에는 동일한 PHP 확장 버전이 필요합니다. 애플리케이션 에서 동일한 라이브러리 및 확장 버전을 사용하는 것이 좋습니다.

PHP 라이브러리 및 해당 요구 사항에 대한 자세한 학습 은 Packagegist의 mongodb/mongodb 패키지 참조하세요.

팁

Laravel MongoDB를 다운로드하고 첫 번째 애플리케이션을 만드는 방법은 시작하기를 참조하세요.

Laravel 호환성

이 섹션에서는 Laravel Integration 버전과 Laravel 버전 간의 호환성을 보여줍니다. 세를 내의 체크표(✓)는 Laravel Integration 버전이 Laravel 버전과 완전히 호환되는 경우를 의미합니다. 빈 세를 조합이 호환되지 않거나 테스트되지 않았다는 의미입니다.

Laravel MongoDB 버전	Laravel 13.x	Laravel 12.x	Laravel 11.x	Laravel 10.x
5.9 ~ 5.12	✓	✓
5.7 ~ 5.8	✓	✓	✓	✓
5.2 ~ 5.6		✓	✓	✓
4.2 ~ 5.1			✓	✓
4.1				✓
4.0				✓

유지 관리되지 않는 Laravel 통합 버전에 대한 호환성 정보를 찾으려면 Github 의 Laravel 버전 호환성 을 참조하세요.

PHP 호환성

이 섹션에서는 Laravel MongoDB Integration 버전과 PHP 버전 간의 호환성을 보여줍니다. 셀의 체크 표시(✓)는 Laravel MongoDB Integration 버전이 해당 PHP 버전과 완전히 호환됨을 의미합니다. 빈 셀은 해당 조합이 호환되지 않거나 테스트되지 않았음을 의미합니다.

다음 표는 Laravel MongoDB와 PHP 간의 호환성을 보여줍니다.

Laravel MongoDB 버전	PHP 8.5	PHP 8.4	PHP 8.3	PHP 8.2	PHP 8.1
5.9 ~ 5.11	✓	✓	✓	✓
4.0 ~ 5.8	✓	✓	✓	✓	✓

PHP 드라이버 호환성

Laravel MongoDB 5.2 이상에는 MongoDB PHP 라이브러리의 v1.21 및 MongoDB PHP 확장이 필요합니다.

중요

MongoDB PHP 확장 프로그램 v2.0 호환성

MongoDB PHP 확장을 v2.0으로 업그레이드 경우, Laravel MongoDB 도 v5.2.1으로 업그레이드 해야 합니다. Laravel MongoDB v5.2.1 여전히 확장자의 v1.x를 지원합니다.

팁

PyMongo 드라이버를 다운로드하고 첫 번째 애플리케이션을 만들는 방법을 학습하려면 시작하기를 참조하세요.

MongoDB 서버 호환성

이 섹션에서는 MongoDB Server 버전과 운전자 버전 간의 호환성에 대해 설명합니다. 다음 표에서는 호환성 수준을 설명합니다.

Icon	설명
✓	모든 기능이 지원됩니다.
⊛	드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
✗	드라이버 버전은 MongoDB 버전에서 작동하지 않습니다. MongoDB 버전에 연결을 시도하면 오류가 발생합니다.
표시 없음	드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

다음 표는 PyMongo 와 MongoDB Server 간의 호환성을 보여줍니다.

PyMongo 버전	MongoDB 9.0	MongoDB 8.0	MongoDB 7.0	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2	MongoDB 4.0
4.18	✓	✓	✓	✓	✓	✓
4.17	⊛	✓	✓	✓	✓	✓	✓
4.14 ~ 4.16		✓	✓	✓	✓	✓	✓
4.9 ~ 4.13		✓	✓	✓	✓	✓	✓	✓
4.4 ~ 4.8		⊛	✓	✓	✓	✓	✓	✓
4.2 ~ 4.3		⊛	⊛	✓	✓	✓	✓	✓
3.7 ~ 4.1		⊛	⊛	⊛	✓	✓	✓	✓

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

애플리케이션 현재 지원되는 MongoDB 버전에서 작동하는 경우 9.0에서도 작동해야 하지만, 비프로덕션 환경에서 테스트할 것을 적극 권장합니다. 부분적으로 호환되는 운전자 버전은 연결 중인 MongoDB Server 버전의 모든 새로운 기능 지원 하지 않습니다. 4.17 에서 4.17 사이의 모든 PyMongo 버전은 MongoDB Server 9.0과 부분적으로 호환됩니다.

애플리케이션 MongoDB 9.0에서 작동하지 않는 경우, 해당 애플리케이션과 완전히 호환되는(✓) 드라이버 버전으로 업그레이드하는 것이 좋습니다. PyMongo 의 경우 여기에는 버전 4.18 이상이 포함됩니다. 완전히 호환되는 드라이버 버전을 사용하면 장기적인 안정성이 보장되고 애플리케이션이 최신 MongoDB 기능을 사용할 수 있습니다.

각 운전자 버전에 추가되거나 제거된 기능 목록은 드라이버의 출시하다 노트를 참조하세요. 각 MongoDB Server 버전에 추가되거나 제거된 기능 목록은 MongoDB Server 출시 노트를 참조하세요.

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

현재 MongoDB Server 버전이 수명 종료(EOL) 날짜에 도달하여 드라이버 버전을 업그레이드하는 경우, MongoDB 버전과 완전히 호환되는(✓) 드라이버 버전을 사용하는 것이 좋습니다. 예시 를 들어 MongoDB Server 8.0으로 업그레이드하는 경우 PyMongo 버전 4.9 이상을 사용할 수 있습니다.

그러나 MongoDB Server 9.0으로 업그레이드하는 경우 운전자 버전 4.18 이상으로 업그레이드하는 것이 좋습니다. 이렇게 하면 애플리케이션이 MongoDB Server 9.0 에서 제공되는 모든 기능을 사용할 수 있으며 향후 버전과의 텀 호환성을 제공할 수 있습니다.

내 운전자 버전은 언제 EOL에 도달하나요?

새 운전자 버전은 지난 3년 이내에 EOL에 도달한 모든 MongoDB Server 버전과 완벽하게 호환됩니다. 이 기간이 지나면 새 운전자 버전이 EOL MongoDB Server 버전과 완전히 호환되지 않을 수 있습니다.

예시, MongoDB Server 8.0은 2029월 일부로 EOL입니다. 8월 2032 까지의 모든 PyMongo 릴리스는 MongoDB Server 8.0과 완전히 호환됩니다.

장기적인 호환성과 보안을 보장하려면 MongoDB Server 버전이 만료되기 전에 운전자 업그레이드하는 것이 좋습니다. MongoDB Server 출시하다 및 EOL 날짜에 대한 자세한 학습 은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

Python 호환성

PyMongo는 CPython과 PyPy를 모두 지원합니다.

Python 버전이 수명 종료(EOL)로 표시되면 PyMongo의 다음 마이너 릴리스에서 해당 버전에 대한 지원이 중단됩니다. 이 드라이버는 EOL Python 버전에 대해 다음과 같은 지속적인 지원을 제공합니다.

CPython: EOL CPython 버전과 호환되는 마지막 마이너 PyMongo 버전은 1년 동안 중요한 버그 수정을 받습니다.
PyPy: PyMongo는 EOL 날짜가 지난 PyPy 버전을 지원하지 않습니다.

Python 3

CPython

이 섹션에서는 PyMongo 버전과 CPython 버전 간의 호환성을 볼 수 있습니다. 세를 표시하는 확인 표(✓)는 PyMongo 버전이 CPython 버전과 완전히 호환된다는 의미입니다. 빈 세를 조합이 호환되지 않거나 테스트되지 않았다는 의미입니다.

PyMongo 버전	CPython 3.15	CPython 3.14	CPython 3.13	CPython 3.12	CPython 3.11	CPython 3.10 [13]	CPython 3.9	CPython 3.8	CPython 3.7	CPython 3.6	CPython 3.5	CPython 3.4
4.19	✓	✓	✓	✓	✓
4.14 ~ 4.18		✓	✓	✓	✓	✓	✓
4.11 ~ 4.13			✓	✓	✓	✓	✓
4.9 ~ 4.10				✓	✓	✓	✓	✓
4.8				✓	✓	✓	✓	✓
4.5 ~ 4.7				✓	✓	✓	✓	✓	✓
4.3 ~ 4.4					✓	✓	✓	✓	✓
4.2						✓	✓	✓	✓
4.1 [14]						✓	✓	✓	✓	✓
4.0						✓	✓	✓	✓	✓
3.13					✓	✓	✓	✓	✓	✓	✓	✓
3.12						✓	✓	✓	✓	✓	✓	✓
3.11							✓	✓	✓	✓	✓	✓
3.10								✓	✓	✓	✓	✓
3.7 ~ 3.9									✓	✓	✓	✓

PyPy

이 섹션에서는 PyMongo 버전과 PyPy 버전 간의 호환성을 볼 수 있습니다. 세를 표시하는 체크 표(✓)는 PyMongo 버전이 PyPy 버전과 완전히 호환되는 경우를 의미합니다. 빈 세를 조합이 호환되지 않거나 테스트되지 않았다는 의미입니다.

PyMongo 버전	PyPy3.11	PyPy3.10	PyPy3.9	PyPy3.8	PyPy3.7	PyPy3.6	PyPy3.5
4.19
4.16 ~ 4.18	✓
4.11 ~ 4.15		✓
4.8 ~ 4.10		✓	✓
4.5 ~ 4.7		✓	✓	✓
4.2 ~ 4.4		✓	✓	✓	✓
4.1 [14]		✓	✓	✓	✓	✓
4.0		✓	✓	✓	✓	✓
3.12		✓	✓	✓	✓	✓	✓
3.11			✓	✓	✓	✓	✓
3.10				✓	✓	✓	✓
3.7 ~ 3.9					✓	✓	✓

[13]	Python 3.10 이상 버전은 MongoDB 4.0 이전 버전의 TLS/SSL과 호환되지 않습니다. 자세한 내용은 TLS 페이지의 문제 해결 섹션을 참조하세요.

[ 14 ]

(1, 2) PyMongo 4.1에는 Python 3.6.2 이상이 필요합니다.

Python 2

PyMongo 버전 3.7 ~ 3.12 은 Python 2.7 및 PyPy2.7와 호환됩니다. 그러나 경우에 따라 PyMongo 애플리케이션은 Python 2 환경에서 실행 때 다르게 동작합니다.

다음 섹션에서는 PyMongo 사용할 때 Python 2 과 Python 3 간의 동작 차이점에 대해 설명합니다.

이진 데이터

모든 버전의 Python 에서 PyMongo 바이트열 클래스의 인스턴스를 바이너리 데이터의 기본값 하위 유형인 하위 유형 0를 사용하여 바이너리 데이터로 인코딩합니다. Python 3에서 PyMongo 이러한 값을 bytes 클래스의 인스턴스로 디코딩합니다. Python 2 에서 운전자 이를 하위 유형 인 바이너리 클래스의 인스턴스로 0 디코딩합니다.

다음 코드 예시는 PyMongo bytes 클래스의 인스턴스를 디코딩하는 방법을 보여줍니다. 해당 코드를 보려면 Python 2 또는 Python 3 탭 선택합니다.

from pymongo import MongoClient
client = MongoClient()
client.test.test.insert_one({'binary': b'this is a byte string'})
doc = client.test.test.find_one()
print(doc)

{u'_id': ObjectId('67afb78298f604a28f0247b4'), u'binary': Binary('this is a byte string', 0)}

from pymongo import MongoClient
client = MongoClient()
client.test.test.insert_one({'binary': b'this is a byte string'})
doc = client.test.test.find_one()
print(doc)

{'_id': ObjectId('67afb78298f604a28f0247b4'), 'binary': b'this is a byte string'}

드라이버 하위 유형이 0인 JSON 바이너리 값을 디코딩할 때 동일한 방식으로 작동합니다. Python 3에서는 이러한 값을 bytes 클래스의 인스턴스로 디코딩합니다. Python 2에서 드라이버는 이를 하위 유형 0인 Binary 클래스의 인스턴스로 디코딩합니다. 차이점을 보여주는 코드 예시는 확장 JSON 페이지를 참조하세요.

피클된 객체 ID

Python 2 에서 ObjectId 를 피클링하고 Python 3에서 피클링을 해제하려면 encoding='latin-1' 을 pickle.loads() 메서드에 인수로 전달해야 합니다.

다음 예시 Python 3 를 사용하여 Python 2에서 피클된 ObjectId 피클을 해제하는 방법을 보여 줍니다.

import pickle
pickle.loads(b'<ObjectId byte stream>', encoding='latin-1')

Python 3 애플리케이션 호환되는 직렬화 프로토콜 사용하여 ObjectId을(를) 피클하는 경우, Python 2 을(를) 사용하여 피클을 해제할 수 있습니다. Python 3에서 호환되는 프로토콜 지정하려면 pickle.dumps() 메서드의 protocol 매개 변수에 0, 1 또는 2 값을 전달합니다.

다음 예시 에서는 Python 3에서 ObjectId 를 피클링한 다음 ObjectId 및 결과 bytes 인스턴스 인쇄합니다.

import pickle
from bson.objectid import ObjectId
oid = ObjectId()
oid_bytes = pickle.dumps(oid, protocol=2)
print("ObjectId: {}".format(oid))
print("ObjectId bytes: {}".format(oid_bytes))

ObjectId: 67af9b1fae9260c0e97eb9eb
ObjectId bytes: b'\x80\x02cbson.objectid\nObjectId\nq\x00...

다음 예시 이전 예시 에서 ObjectId 을 언피클링한 다음 bytes 및 ObjectId 인스턴스를 출력합니다.

import pickle
from bson.objectid import ObjectId
oid_bytes = b'\x80\x02cbson.objectid\nObjectId\nq\x00...'
oid = pickle.loads(oid_bytes)
print("ObjectId bytes: {}".format(oid_bytes))
print("ObjectId: {}".format(oid))

ObjectId bytes: b'\x80\x02cbson.objectid\nObjectId\nq\x00)...
ObjectId: 67af9b1fae9260c0e97eb9eb

팁

PyMongoArrow를 다운로드하고 첫 번째 애플리케이션을 만드는 방법을 학습하려면 시작하기를 참조하세요.

MongoDB 서버 호환성

지원되는 MongoDB Server 버전은 PyMongo 버전에 따라 다릅니다. PyMongo가 지원하는 서버 버전을 확인하려면 PyMongo 호환성 페이지의 MongoDB Server 호환성 을(를) 참조하세요.

PyArrow 호환성

다음 표에는 각 PyMongoArrow 버전에 필요한 PyArrow 버전이 나열되어 있습니다.

PyMongoArrow 버전	PyArrow 버전
1.15.x	25.x
1.14.x	24.x
1.12.x - 1.13.x	23.x
1.11.x	22.x
1.10.x	21.x
1.8.x - 1.9.x	20.x
1.7.x	19.x
1.6.x	18.x
1.5.x	17.x
1.4.X	16.x

Python 호환성

PyMongoArrow에는 CPython 3.10, 3.11, 3.12, 3.13 또는 3.14가 필요합니다.

PyMongo 호환성

PyMongoArrow에는 PyMongo 4.4 이상이 필요합니다.

2025년 5월 14일부로 PyMongo 라이브러리에 PyMongo 비동기 API(GA 릴리스)가 출시되면서 Motor는 더 이상 지원되지 않습니다. Motor에는 더 이상 새로운 기능이 추가되지 않으며, 2026년 5월 14일에 지원 종료 전까지 버그 수정만 제공될 예정입니다. 그 후에는 2027년 5월 14일까지 최종 지원이 종료될 때까지 중요 버그만 수정될 예정입니다. Motor의 지원이 유지되는 동안 PyMongo 비동기 API로의 전환을 적극 권장드립니다.

마이그레이션에 대한 자세한 내용은 PyMongo 문서의 PyMongo 비동기로 마이그레이션 가이드를 참조하세요.

MongoDB 서버 호환성

이 섹션에서는 MongoDB Server 버전과 운전자 버전 간의 호환성에 대해 설명합니다. 다음 표에서는 호환성 수준을 설명합니다.

Icon	설명
✓	모든 기능이 지원됩니다.
⊛	드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
✗	드라이버 버전은 MongoDB 버전에서 작동하지 않습니다. MongoDB 버전에 연결을 시도하면 오류가 발생합니다.
표시 없음	드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

다음 표는 Motor와 MongoDB Server 간의 호환성을 보여줍니다.

모터 드라이버 버전	MongoDB 9.0	MongoDB 8.0	MongoDB 7.0	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2	MongoDB 4.0	MongoDB 3.6
3.7	⊛	✓	✓	✓	✓	✓	✓	✓
3.6		✓	✓	✓	✓	✓	✓	✓	✓
3.2 ~ 3.5		⊛	✓	✓	✓	✓	✓	✓	✓
3.1		⊛	⊛	✓	✓	✓	✓	✓	✓
3.0		⊛	⊛	⊛	✓	✓	✓	✓	✓

Python 호환성

이 섹션에서는 Motor 버전과 Python 버전 간의 호환성을 보여줍니다. 세를 체크표시(✓)는 Motor 버전이 Python 버전과 완전히 호환된다는 의미입니다. 빈 세를 조합이 호환되지 않거나 테스트되지 않았다는 의미입니다.

다음 표는 Motor와 Python 간의 호환성을 보여줍니다.

모터 드라이버 버전	Python 3.13	Python 3.12	Python 3.11	Python 3.10	Python 3.9	Python 3.8	Python 3.7
3.7	✓	✓	✓	✓	✓
3.6	✓	✓	✓	✓	✓	✓
3.5		✓	✓	✓	✓	✓
3.3 ~ 3.4		✓	✓	✓	✓	✓	✓
3.1 ~ 3.2			✓	✓	✓	✓	✓
3.0				✓	✓	✓	✓

참고

asyncio 지원

asyncio 지원 의 경우, 모터 Python 3.4 이상 또는 PyPI의asyncio 패키지포함된 Python 3.3 이 필요합니다.

PyMongo 호환성

다음 표는 Motor 및 PyMongo 의 동등한 버전을 보여줍니다.

모터 버전	PyMongo 버전
3.7	4.10
3.6	4.9
3.3	4.4
3.1	4.2
3.0	4.0

팁

Django MongoDB 백엔드를 다운로드하고 첫 번째 애플리케이션을 만드는 방법을 학습하려면 시작하기를 참조하세요.

PyMongo 호환성

장고 MongoDB 백엔드는 PyMongo 4.7 이상을 지원합니다.

MongoDB 서버 호환성

이 섹션에서는 MongoDB Server 버전과 운전자 버전 간의 호환성에 대해 설명합니다. 다음 표에서는 호환성 수준을 설명합니다.

Icon	설명
✓	모든 기능이 지원됩니다.
⊛	드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
✗	드라이버 버전은 MongoDB 버전에서 작동하지 않습니다. MongoDB 버전에 연결을 시도하면 오류가 발생합니다.
표시 없음	드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

다음 표는 Django MongoDB 백엔드와 MongoDB Server 간의 호환성을 보여줍니다.

장고 MongoDB 백엔드 버전	MongoDB 9.0	MongoDB 8.0	MongoDB 7.0	MongoDB 6.0
6.1	✓	✓	✓
6.0	✓	✓	✓
5.2	✓	✓	✓	✓

Django 호환성

Django MongoDB 백엔드의 메이저 버전과 마이너 버전이 사용 중인 Django 버전과 일치해야 합니다. 예시 들어, Django MongoDB 백엔드 6.0 에는 Django 6.0이 필요합니다.

언어 호환성

이 섹션에서는 Django MongoDB 백엔드 버전과 Python 버전 간의 호환성을 보여줍니다. 세를에 체크 표시(✓)가 있다는 것은 Django MongoDB 백엔드 버전이 Python 버전과 완전히 호환된다는 의미입니다. 빈 세를 조합이 호환되지 않거나 테스트되지 않았다는 의미입니다.

다음 표는 장고 MongoDB 백엔드와 Python 간의 호환성을 보여줍니다.

장고 MongoDB 백엔드 버전	Python 3.14	Python 3.13	Python 3.12	Python 3.11	Python 3.10
6.1	✓	✓	✓
6.0	✓	✓	✓
5.2	✓	✓	✓	✓	✓

팁

Ruby 드라이버를 다운로드하고 첫 번째 애플리케이션을 만드는 방법을 학습하려면 시작하기를 참조하세요.

MongoDB 서버 호환성

이 섹션에서는 MongoDB Server 버전과 운전자 버전 간의 호환성에 대해 설명합니다. 다음 표에서는 호환성 수준을 설명합니다.

Icon	설명
✓	모든 기능이 지원됩니다.
⊛	드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
✗	드라이버 버전은 MongoDB 버전에서 작동하지 않습니다. MongoDB 버전에 연결을 시도하면 오류가 발생합니다.
표시 없음	드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

다음 표는 Ruby 드라이버와 MongoDB Server 간의 호환성을 보여줍니다.

루비 드라이버	MongoDB 9.0	MongoDB 8.0	MongoDB 7.0	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2
2.26	✓	✓	✓	✓	✓	✓	✗
2.24 ~ 2.25	⊛	✓	✓	✓	✓	✓	✓
2.21 ~ 2.23		✓	✓	✓	✓	✓	✓
2.19 ~ 2.20		⊛	✓	✓	✓	✓	✓
2.18		⊛	⊛	✓	✓	✓	✓
2.16 ~ 2.17		⊛	⊛	⊛	✓	✓	✓
2.14 ~ 2.15		⊛	⊛	⊛	⊛	✓	✓
2.13		⊛	⊛	⊛	⊛	✓ [15]	✓
2.12		⊛	⊛	⊛	⊛	⊛	✓
2.11		⊛	⊛	⊛	⊛	⊛	✓ [16]
2.10		⊛	⊛	⊛	⊛	⊛	✓ [17] [16]

[15]	OCSP 확인은 드라이버 버전 2.14 부터 구현됩니다.

[17]	샤딩된 토폴로지에서 SRV 레코드의 폴링은 운전자 버전 2.11 부터 구현됩니다.

[ 16 ]

(1, 2) 클라이언트 사이드 암호화 는 운전자 버전 2.12.

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

애플리케이션 현재 지원되는 MongoDB 버전에서 작동하는 경우 9.0에서도 작동해야 하지만, 비프로덕션 환경에서 테스트할 것을 적극 권장합니다. 부분적으로 호환되는 운전자 버전은 연결 중인 MongoDB Server 버전의 모든 새로운 기능 지원 하지 않습니다. 2.24 ~ 2.25 사이의 모든 버전의 Ruby 드라이버는 MongoDB Server 9.0과 부분적으로 호환됩니다.

애플리케이션 MongoDB 9.0에서 작동하지 않는 경우, 해당 애플리케이션과 완전히 호환되는(✓) 드라이버 버전으로 업그레이드하는 것이 좋습니다. Ruby 드라이버의 경우 여기에는 버전 2.26 이상이 포함됩니다. 완전히 호환되는 드라이버 버전을 사용하면 장기적인 안정성이 보장되고 애플리케이션이 최신 MongoDB 기능을 사용할 수 있습니다.

각 운전자 버전에 추가되거나 제거된 기능 목록은 드라이버의 출시하다 노트를 참조하세요. 각 MongoDB Server 버전에 추가되거나 제거된 기능 목록은 MongoDB Server 출시 노트를 참조하세요.

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

현재 MongoDB Server 버전이 수명 종료(EOL) 날짜에 도달하여 드라이버 버전을 업그레이드하는 경우, MongoDB 버전과 완전히 호환되는(✓) 드라이버 버전을 사용하는 것이 좋습니다. 예시를 들어 MongoDB Server 8.0으로 업그레이드하는 경우 Ruby 드라이버 버전 2.21 이상을 사용할 수 있습니다.

그러나 MongoDB Server 9.0으로 업그레이드하는 경우 운전자 버전 2.26 이상으로 업그레이드하는 것이 좋습니다. 이렇게 하면 애플리케이션이 MongoDB Server 9.0 에서 제공되는 모든 기능을 사용할 수 있으며 향후 버전과의 텀 호환성을 제공할 수 있습니다.

내 운전자 버전은 언제 EOL에 도달하나요?

새 운전자 버전은 지난 3년 이내에 EOL에 도달한 모든 MongoDB Server 버전과 완벽하게 호환됩니다. 이 기간이 지나면 새 운전자 버전이 EOL MongoDB Server 버전과 완전히 호환되지 않을 수 있습니다.

예시, MongoDB Server 8.0은 2029월 일부로 EOL입니다. 8월 2032 일까지 모든 Ruby 드라이버 릴리스는 MongoDB Server 8.0과 완전히 호환됩니다.

장기적인 호환성과 보안을 보장하려면 MongoDB Server 버전이 만료되기 전에 운전자 업그레이드하는 것이 좋습니다. MongoDB Server 출시하다 및 EOL 날짜에 대한 자세한 학습 은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

Ruby 호환성

이 섹션에서는 Ruby 드라이버 버전과 Ruby 버전 간의 호환성을 보여줍니다. 세포의 확인 표시(✓)는 Ruby 드라이버 버전이 Ruby 버전과 완전히 호환되는 것을 의미합니다. 빈 세를 조합이 호환되지 않거나 테스트되지 않았다는 의미입니다.

다음 표는 Ruby 드라이버와 Ruby 간의 호환성을 보여줍니다.

루비 드라이버	Ruby 4.0	Ruby 3.3	Ruby 3.2	Ruby 3.1	Ruby 3.0	Ruby 2.7	JRuby 9.4	JRuby 9.3	JRuby 9.2
2.23.0 ~ 2.26.0	✓	✓	✓	✓	✓		✓	✓
2.21.1 ~ 2.22.0		✓	✓	✓	✓		✓	✓
2.20 ~ 2.21.0			✓	✓	✓		✓	✓
2.19			✓	✓	✓	✓		✓	✓

이 운전자 는 이전 버전의 Ruby 를 지원 하지 않습니다.

Rails/ActiveSupport 호환성

Ruby 운전자 ActiveSupport에 의존하지 않습니다. 그러나 애플리케이션 에서 ActiveSupport 또는 Ruby on Rails를 사용하는 경우 시간 직렬화와 같은 동작이 올바르게 작동하려면 드라이버의 ActiveSupport 호환성 코드를 로드해야 합니다.

require 'mongo'
require 'mongo/active_support'

Mongoid 7.0.6 이상을 사용하는 애플리케이션은 Mongoid가 자동으로 로드하기 때문에 드라이버의 ActiveSupport 코드를 명시적으로 로드할 필요가 없습니다.

TLS/SSL 호환성

Ruby 운전자 기본 Ruby openssl 확장에서 지원하는 프로토콜을 사용합니다. openssl 확장은 일반적으로 운영 체제의 OpenSSL 라이브러리에서 사용할 수 있는 기능을 노출합니다.

업계 권장사항 및 일부 규정에서는 TLS 1.1 이상을 사용해야 합니다. 일부 운영 체제 또는 버전에서는 이러한 TLS 버전을 지원하는 OpenSSL 버전을 제공하지 않을 수 있습니다.

10.13 (High Sierra) 이전의 macOS 버전을 사용하는 경우 rvm, 홈브루, macports 또는 기타 유사한 소스에서 Ruby 설치해야 합니다. 더 많은 옵션은 Ruby 설치 를 참조하세요.

Linux 또는 기타 비 macOS Unix 시스템을 사용하는 경우 다음과 같이 OpenSSL 버전을 확인할 수 있습니다.

openssl version

버전 번호가 1.0.1 이전인 경우, TLS 1.1 이상에 대한 지원 사용할 수 없습니다. 솔루션 또는 최신 배포판으로 업그레이드 하려면 운영 체제 벤더 에 문의하세요.

다음 명령을 실행 하여 TLS 버전을 확인할 수 있습니다.

ruby -e "require 'net/http'; require 'json'; puts JSON.parse(Net::HTTP.get(URI('https://www.howsmyssl.com/a/check')))['tls_version']"

명령을 실행 후 X 이 1 이상인 TLS 1.X 을 확인해야 합니다.

TLS 버전과 해당 버전이 보안에 미치는 영향에 대해 자세히 학습 전송 계층 보안 치트 시트를 참조하세요.

참고

JRuby 제한 사항

JRuby의 제한 사항으로 인해 운전자 ECDSA 서버 인증서 또는 OCSP 엔드포인트 확인을 지원 하지 않습니다.

팁

Mongoid를 다운로드하고 첫 애플리케이션을 만드는 방법을 학습하려면 시작하기를 참조하세요.

MongoDB 서버 호환성

세르의 체크 표시(✓)는 Mongoid 버전이 MongoDB Server 버전과 호환되는 경우를 의미합니다. 빈 세를은 조합이 호환되지 않거나 테스트되지 않음을 의미합니다.

다음 표는 Mongoid와 MongoDB Server 간의 호환성을 보여줍니다.

Mongoid 버전	MongoDB 9.0	MongoDB 8.0	MongoDB 7.0	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2
9.0 ~ 9.1	⊛	✓	✓	✓	✓	✓	✓
8.0 ~ 8.1			✓	✓	✓	✓	✓

Ruby 호환성

이 섹션에서는 Mongoid 버전과 Ruby 버전 간의 호환성을 보여줍니다. 세를에 표시된 체크 표(✓)는 Mongoid 버전이 Ruby 버전과 완전히 호환되는 경우를 의미합니다. 빈 세를 조합이 호환되지 않거나 테스트되지 않았다는 의미입니다.

Mongoid 버전	Ruby 4.0	Ruby 3.2	Ruby 3.1	Ruby 3.0	Ruby 2.7	Ruby 2.6	JRuby 9.4	JRuby 9.3
9.0 ~ 9.1	✓ [18]	✓	✓	✓	✓		✓
8.1		✓	✓	✓	✓	✓		✓
8.0			✓	✓	✓	✓		✓

[18]	Mongoid v9.0.11 Ruby 4.0에 대한 공식 지원 도입합니다.

Ruby 드라이버 호환성

Mongoid 8.0 ~ 9.0 에는 MongoDB Ruby 드라이버 2.18 이상이 필요합니다.

참고

패치 버전 호환성

동일한 마이너 출시하다 에 포함된 이전 패치 버전의 Mongoid는 이전 Ruby 운전자 버전을 지원 수 있습니다. 예시 들어, Mongoid v7.0.5 Ruby 운전자 v2.5 이상을 지원하지만 Mongoid v7.0.6 운전자 v2.7 이상이 필요합니다.

Ruby on Rails 호환성

다음 표는 Mongoid와 Ruby on Rails 간의 호환성을 보여줍니다. 세를 내의 체크 표시(✓)는 Mongoid 버전이 Rails 버전과 호환되는 경우를 의미합니다. 빈 세를 조합이 호환되지 않거나 테스트되지 않았다는 의미입니다.

Mongoid 버전	Rails 8.0	Rails 7.2	Rails 7.1	Rails 7.0	Rails 6.1	Rails 6.0	Rails 5.2
9.0 ~ 9.1	✓ [19]	✓ [20]	✓ [21]	✓	✓	✓
8.1	✓ [19]	✓ [20]	✓ [21]	✓	✓	✓	✓ [22]
8.0			✓ [21]	✓	✓	✓	✓ [22]

[ 19 ]

(1, 2) Rails 8.0에는 각 8에서 Mongoid v8.1.7 및 v9.0.3이 필요합니다. .1 및 9.0 안정적인 브랜치입니다.

[ 20 ]

(1, 2) Rails 7.2에는 각 8에서 Mongoid v8.1.6 및 v9.0.2이 필요합니다. .1 및 9.0 안정적인 브랜치입니다.

[ 21 ]

(1, 2, 3) Rails 7.1에는 Mongoid v8.0.7 또는 v8.1.3이 필요합니다. 각각 8.0 및 8.1 안정 브랜치입니다.

[ 22 ]

(1, 2) Ruby 3와 함께 Rails 5.x를 사용하는 것은 지원되지 않습니다.

Rails 프레임워크 지원

Mongoid는 Ruby on Rails를 구성하는 매우 다양한 프레임워크와 호환됩니다. 다음 표에서는 각 프레임워크와 Mongoid의 호환성을 볼 수 있습니다. 확인 표시(✓)는 해당 프레임워크가 지원되었음을 의미합니다. 빈 세를 해당 프레임워크가 Active Record 에 직접 의존하므로 이것없이는 예상대로 작동하지 않을 수 있습니다.

팁

Active Record에 직접 의존하는 프레임워크를 사용하려면 애플리케이션에 Mongoid와 Active Record를 모두 설치하세요.

Rails 프레임워크	Mongoid 지원	참고 사항
`ActionCable`	✓	`ActionCable`에 대한 MongoDB 어댑터는 없지만 Mongoid 모델과 함께 Redis 어댑터와 같은 기존 어댑터를 사용할 수 있습니다.
`ActionMailbox`		액티브 레코드에 직접적으로 의존합니다.
`ActionMailer`	✓
`ActionPack`	✓
`ActionText`		액티브 레코드에 직접적으로 의존합니다.
`ActionView`	✓
`ActiveJob`	✓	`BSON::ObjectId` 값을 문자열로 직렬화하고 작업 내부에서 복원합니다. 자세한 내용은 ActiveJob을 참조하세요.
`ActiveModel`	✓	`Mongoid::Document` 모듈에는 `ActiveModel::Model` 가 포함되어 있으며 문서 유효성 검사를 위해 `ActiveModel::Validations` 를 활용합니다.
`ActiveRecord`	✓	Mongoid는 Active Record의 대체입니다. 동일한 애플리케이션에서 두 개 모두 실행할 수 있습니다.
`ActiveStorage`		액티브 레코드에 직접적으로 의존합니다.
`ActiveSupport`	✓	`Mongoid` 모듈에는 `ActiveSupport`이(가) 필요합니다. `Mongoid` 는 시간 값을 처리하기 위해 `ActiveSupport::TimeWithZone` 을 사용합니다.

팁

Rust 드라이버를 다운로드하고 첫 번째 애플리케이션을 만드는 방법을 학습하려면 시작하기를 참조하세요.

MongoDB 서버 호환성

이 섹션에서는 MongoDB Server 버전과 운전자 버전 간의 호환성에 대해 설명합니다. 다음 표에서는 호환성 수준을 설명합니다.

Icon	설명
✓	모든 기능이 지원됩니다.
⊛	드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
✗	드라이버 버전은 MongoDB 버전에서 작동하지 않습니다. MongoDB 버전에 연결을 시도하면 오류가 발생합니다.
표시 없음	드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

다음 표는 Rust 드라이버와 MongoDB Server 간의 호환성을 보여줍니다.

Rust 드라이버 버전	MongoDB 9.0	MongoDB 8.0	MongoDB 7.0	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2
3.9 [23]	✓	✓	✓	✓	✓	✓	⊛
3.6에서 3.8 [23]	⊛	✓	✓	✓	✓	✓	✓
3.1에서 3.5 [23]		✓	✓	✓	✓	✓	✓
2.6에서 3.0 [23]		⊛	✓	✓	✓	✓	✓
2.5 [23]		⊛	⊛	⊛	✓	✓	✓
2.4 [24]		⊛	⊛	⊛	✓	✓	✓
2.2에서 2.3 [25]		⊛	⊛	⊛	✓	✓	✓
2.1 [26]		⊛	⊛	⊛	✓	✓	✓
2.0 [27]		⊛	⊛	⊛	✓	✓	✓

Rust 운전자 4.2 이전의 MongoDB Server 버전과 호환되지 않습니다.

[ 23 ]

(1, 2, 3, 4, 5) 이러한 Rust 운전자 버전은 OCSP를 지원 하지 않습니다.

[24]	이 Rust 드라이버 버전은 십진수128 또는 OCSP를 지원하지 않습니다.

[25]	이러한 Rust 운전자 버전은128 십진수, 클라이언트 측 필드 레벨 암호화, GridFS 또는 OCSP를 지원 하지 않습니다.

[26]	이 Rust 드라이버 버전은 십진수128, 클라이언트 사이드 필드 레벨 암호화, GridFS, OCSP 또는 변경 스트림을 지원하지 않습니다.

[27]	이 Rust 드라이버 버전은 십진수128, 클라이언트 사이드 필드 레벨 암호화, GridFS, OCSP, 변경 스트림 또는 인과적 일관성지원 하지 않습니다.

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

애플리케이션 현재 지원되는 MongoDB 버전에서 작동하는 경우 9.0에서도 작동해야 하지만, 비프로덕션 환경에서 테스트할 것을 적극 권장합니다. 부분적으로 호환되는 운전자 버전은 연결 중인 MongoDB Server 버전의 모든 새로운 기능 지원 하지 않습니다. 3.6 와 3.8 사이의 모든 버전의 Rust 드라이버는 MongoDB Server 9.0과 부분적으로 호환됩니다.

애플리케이션 MongoDB 9.0에서 작동하지 않는 경우, 해당 애플리케이션과 완전히 호환되는(✓) 드라이버 버전으로 업그레이드하는 것이 좋습니다. Rust 드라이버의 경우 여기에는 버전 3.9 이상이 포함됩니다. 완전히 호환되는 드라이버 버전을 사용하면 장기적인 안정성이 보장되고 애플리케이션이 최신 MongoDB 기능을 사용할 수 있습니다.

각 운전자 버전에 추가되거나 제거된 기능 목록은 드라이버의 출시하다 노트를 참조하세요. 각 MongoDB Server 버전에 추가되거나 제거된 기능 목록은 MongoDB Server 출시 노트를 참조하세요.

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

현재 MongoDB Server 버전이 수명 종료(EOL) 날짜에 도달하여 드라이버 버전을 업그레이드하는 경우, MongoDB 버전과 완전히 호환되는(✓) 드라이버 버전을 사용하는 것이 좋습니다. 예시를 들어 MongoDB Server 8.0으로 업그레이드하는 경우 Rust 드라이버 버전 3.1 이상을 사용할 수 있습니다.

그러나 MongoDB Server 9.0으로 업그레이드하는 경우 운전자 버전 3.9 이상으로 업그레이드하는 것이 좋습니다. 이렇게 하면 애플리케이션이 MongoDB Server 9.0 에서 제공되는 모든 기능을 사용할 수 있으며 향후 버전과의 텀 호환성을 제공할 수 있습니다.

내 운전자 버전은 언제 EOL에 도달하나요?

새 운전자 버전은 지난 3년 이내에 EOL에 도달한 모든 MongoDB Server 버전과 완벽하게 호환됩니다. 이 기간이 지나면 새 운전자 버전이 EOL MongoDB Server 버전과 완전히 호환되지 않을 수 있습니다.

예시 들어, MongoDB Server 8.0은 2029년 월부로 EOL되었습니다. 8월 2032 까지의 모든 Rust 드라이버 릴리스는 MongoDB Server 8.0과 완전히 호환됩니다.

장기적인 호환성과 보안을 보장하려면 MongoDB Server 버전이 만료되기 전에 운전자 업그레이드하는 것이 좋습니다. MongoDB Server 출시하다 및 EOL 날짜에 대한 자세한 학습 은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

Rust 호환성

이 섹션에서는 Rust 드라이버 버전과 Rust 버전 간의 호환성을 보여줍니다. 세를의 확인 표시(✓)는 Rust 드라이버 버전이 Rust 버전과 완전히 호환된다는 의미입니다. 빈 세를 조합이 호환되지 않거나 테스트되지 않았다는 의미입니다.

다음 표에는 Rust 드라이버의 각 버전에 대한 MSRV(Minimum Supported Rust Version)가 나와 있습니다.

Rust 드라이버 버전	지원되는 최소 Rust 버전
3.7	1.88
3.6	1.85
3.3 ~ 3.5	1.83
3.2	1.71.1
2.8 ~ 3.1	1.61.0
2.4 ~ 2.7	1.57.0

참고

MSRV 업데이트

Rust 운전자 메이저 및 마이너 릴리스에서만 MSRV(Minimum Supported Rust Version)를 업데이트하며, 최소 6개월 이상 사용된 Rust 버전으로만 업데이트합니다.

팁

Scala 드라이버를 다운로드하고 첫 번째 애플리케이션을 만드는 방법을 학습하려면 시작하기를 참조하세요.

MongoDB 서버 호환성

이 섹션에서는 MongoDB Server 버전과 운전자 버전 간의 호환성에 대해 설명합니다. 다음 표에서는 호환성 수준을 설명합니다.

Icon	설명
✓	모든 기능이 지원됩니다.
⊛	드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
✗	드라이버 버전은 MongoDB 버전에서 작동하지 않습니다. MongoDB 버전에 연결을 시도하면 오류가 발생합니다.
표시 없음	드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

다음 표는 Scala 드라이버와 MongoDB Server 간의 호환성을 보여줍니다.

Scala 드라이버 버전	MongoDB 9.0	MongoDB 8.3	MongoDB 8.1 ~ 8.2	MongoDB 8.0	MongoDB 7.0	MongoDB 6.1	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2
5.12 ~ 5.13	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
5.9 ~ 5.11	⊛	✓	✓	✓	✓	✓	✓	✓	✓	✓
5.8		✓	✓	✓	✓	✓	✓	✓	✓	✓
5.2 ~ 5.7		⊛	✓	✓	✓	✓	✓	✓	✓	✓
4.10 ~ 5.1		⊛	⊛	⊛	✓	✓	✓	✓	✓	✓
4.8 ~ 4.9		⊛	⊛	⊛	⊛	✓	✓	✓	✓	✓
4.7		⊛	⊛	⊛	⊛	⊛	✓	✓	✓	✓

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

애플리케이션 현재 지원되는 MongoDB 버전에서 작동하는 경우 9.0에서도 작동해야 하지만, 비프로덕션 환경에서 테스트할 것을 적극 권장합니다. 부분적으로 호환되는 운전자 버전은 연결 중인 MongoDB Server 버전의 모든 새로운 기능 지원 하지 않습니다. 5.9 와 5.11 사이의 모든 버전의 Scala 드라이버는 MongoDB Server 9.0과 부분적으로 호환됩니다.

애플리케이션 MongoDB 9.0에서 작동하지 않는 경우, 해당 애플리케이션과 완전히 호환되는(✓) 드라이버 버전으로 업그레이드하는 것이 좋습니다. Scala 드라이버의 경우, 여기에는 버전 5.12 이상이 포함됩니다. 완전히 호환되는 드라이버 버전을 사용하면 장기적인 안정성이 보장되고 애플리케이션이 최신 MongoDB 기능을 사용할 수 있습니다.

각 운전자 버전에 추가되거나 제거된 기능 목록은 드라이버의 출시하다 노트를 참조하세요. 각 MongoDB Server 버전에 추가되거나 제거된 기능 목록은 MongoDB Server 출시 노트를 참조하세요.

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

현재 MongoDB Server 버전이 수명 종료(EOL) 날짜에 도달하여 드라이버 버전을 업그레이드하는 경우, MongoDB 버전과 완전히 호환되는(✓) 드라이버 버전을 사용하는 것이 좋습니다. 예시를 들어 MongoDB Server 8.0으로 업그레이드하는 경우 Scala 드라이버 버전 5.2 이상을 사용할 수 있습니다.

그러나 MongoDB Server 9.0으로 업그레이드하는 경우 운전자 버전 5.12 이상으로 업그레이드하는 것이 좋습니다. 이렇게 하면 애플리케이션이 MongoDB Server 9.0 에서 제공되는 모든 기능을 사용할 수 있으며 향후 버전과의 텀 호환성을 제공할 수 있습니다.

내 운전자 버전은 언제 EOL에 도달하나요?

새 운전자 버전은 지난 3년 이내에 EOL에 도달한 모든 MongoDB Server 버전과 완벽하게 호환됩니다. 이 기간이 지나면 새 운전자 버전이 EOL MongoDB Server 버전과 완전히 호환되지 않을 수 있습니다.

예시 들어, MongoDB Server 8.0은 2029년 월부로 EOL되었습니다. 8월 2032 까지 모든 Scala 드라이버 릴리스는 MongoDB Server 8.0과 완전히 호환됩니다.

장기적인 호환성과 보안을 보장하려면 MongoDB Server 버전이 만료되기 전에 운전자 업그레이드하는 것이 좋습니다. MongoDB Server 출시하다 및 EOL 날짜에 대한 자세한 학습 은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

Scala 호환성

이 섹션에서는 Scala 드라이버 버전과 Scala 버전 간의 호환성을 보여줍니다. 세를 표시하는 체크 표시(✓)는 Scala 드라이버 버전이 Scala 버전과 완전히 호환되는 경우를 의미합니다. 빈 세를 조합이 호환되지 않거나 테스트되지 않았다는 의미입니다.

Scala 드라이버 버전	Scala 3	Scala 2.13	Scala 2.12	Scala 2.11
5.7+	✓	✓	✓	✓
2.0 ~ 5.6		✓	✓	✓

클라이언트 라이브러리 호환성 표

MongoDB 서버 호환성

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

내 운전자 버전은 언제 EOL에 도달하나요?

C 호환성

플랫폼 호환성

운영 체제

컴파일러

아키텍처

추가 플랫폼

MongoDB 서버 호환성

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

내 운전자 버전은 언제 EOL에 도달하나요?

C++ 호환성

libmongoc 호환성

컴파일러 호환성

MongoDB 서버 호환성

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

내 운전자 버전은 언제 EOL에 도달하나요?

C# 호환성

.NET

.NET Framework

엔터티 프레임워크 핵심 호환성

MongoDB 서버 호환성

.NET 호환성

MongoDB 서버 호환성

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

내 운전자 버전은 언제 EOL에 도달하나요?

고 (Go) 호환성

MongoDB 서버 호환성

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

내 운전자 버전은 언제 EOL에 도달하나요?

Java 호환성

MongoDB 서버 호환성

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

내 운전자 버전은 언제 EOL에 도달하나요?

Java 호환성

최대 절전 모드 호환성

MongoDB 서버 호환성

Java 호환성

Java 드라이버 호환성

Spring 에코시스템 호환성

MongoDB 서버 호환성

Java 호환성

Java 드라이버 호환성

MongoDB 서버 호환성

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

내 운전자 버전은 언제 EOL에 도달하나요?

코틀린 (Kotlin) 호환성

MongoDB 서버 호환성

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

내 운전자 버전은 언제 EOL에 도달하나요?

코틀린 (Kotlin) 호환성

MongoDB 서버 호환성

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?

내 운전자 버전은 언제 EOL에 도달하나요?

노드.js 호환성

컴포넌트 호환성

MongoDB 서버 호환성

자주 묻는 질문

내 운전자 버전은 MongoDB 9.0과 부분적으로 호환됩니다(⊛). 내 애플리케이션 작동하나요?

내 운전자 버전은 7.0 및 8.0과 완전히 호환되지만 MongoDB 7.0 은 EOL입니다. 업그레이드 경로는 어떻게 되나요?