릴리스 노트

새로운 기능

• 서버 응답에 baseBackoffMS 값을 가진 SystemOverloadedError이 포함되어 있을 경우, 드라이버는 기본값 지연 대신 해당 값을 사용하여 다시 시도하기 전에 기다릴 시간을 계산합니다.

• 컬렉션 대량 쓰기 (write) 옵션에 대한 게터를 추가합니다.

개선 사항

• 번들로 제공되는 utf8proc 라이브러리를 2.11.3으로 업데이트합니다.

이 출시하다 에 대한 자세한 내용은 25v..0 출시하다 노트를 참조하세요.

새로운 기능

• Queryable Encryption String 알고리즘(MONGOC_ENCRYPT_ALGORITHM_STRING)은 일반적으로 사용 가능하며 prefix, suffix 및 substring 쿼리 유형을 지원합니다.

  • prefixPreview, suffixPreview, substringPreview 쿼리 유형은 여전히 시험적입니다.

• 스냅샷 세션에 스냅샷 시간을 가져오고 설정하는 API를 추가합니다.

• AWS STS 지역 엔드포인트에 대한 지원을 추가합니다.

개선 사항

• 사용 중 암호화 지원을 위해 필요한 libmongocrypt 버전을 1.15.1에서 1.20.0으로 상향합니다. 이 요구 사항은 ENABLE_CLIENT_SIDE_ENCRYPTION CMake 옵션에 해당합니다.

지원 중단

• String API를 사용하여 Queryable Encryption Text API의 지원이 중단됩니다. 일반적으로 사용 가능한 String 알고리즘과 일치시키려면 mongoc_client_encryption_encrypt_text_* 대신 mongoc_client_encryption_encrypt_string_*를 사용하세요.

수정 사항

• bulkWrite 답변에서 장황한 결과 처리를 수정합니다.

• SCRAM 답변 처리를 수정합니다.

이 출시하다 에 대한 자세한 내용은 24v..0 출시하다 노트를 참조하세요.

수정 사항

• CMake 4.4.0로 드라이버를 구성할 때 발생하는 오류를 수정합니다.

• Windows에서 UNICODE 로 드라이버를 빌드할 때 발생하는 문제를 해결합니다.

• HTTP 처리에 대한 유효성 검사를 강화합니다.

이 출시하다 에 대한 자세한 내용은 23v..3 출시하다 노트를 참조하세요.

수정 사항

• v2.3.0 에서 도입된 문제 수정 killCursors 작업이 실패하여 애플리케이션이 충돌하는 경우.

• SCRAM 인증의 오류 처리를 수정합니다.

이 출시하다 에 대한 자세한 내용은 23v..2 출시하다 노트를 참조하세요.

수정 사항

• bson_new_from_buffer에서 길이 검사를 수정합니다.

• Sphinx 9.0+에서 문서 생성을 수정합니다.

개선 사항

• BIO_FLAGS_AUTO_EOF 가 활성화되어 있는 오래된 스타일의 읽기 콜백에서 EAGAIN 오류를 처리할 때 OpenSSL 4.0.0 과의 전방 호환성이 향상됩니다.

• 압축 해제된 메시지 길이 제한을 개선합니다.

수정 사항

• 사용자 이름을 사용자 지정 OIDC 콜백으로 전파합니다.

• Sphinx 9.0+에서 문서 생성을 수정합니다.

이 출시하다 에 대한 자세한 내용은 23v..1 출시하다 노트를 참조하세요.

개선 사항

• bson_t 쉽게 이동할 수 있습니다.

지원 중단

• bson_append_array_begin()을(를) 더 이상 사용하지 않습니다. 대신 bson_append_array_builder_begin() 또는 bson_append_array_unsafe_begin() 를 사용합니다.

새로운 기능

• 지능형 워크로드 관리(IWM) 및 수신 연결 속도 제한에 대한 지원 추가합니다. 드라이버는 애플리케이션 가용성을 유지하기 위해 쓰기 (write) 차단 시나리오를 처리하고 부하가 높은 조건에서 연결 설정을 최적화합니다. 이러한 기능은 MongoDB 9.0 이상을 실행 Atlas 클러스터에서 사용할 수 있습니다.

  • 이 기능 모든 명령에서 지원됩니다.

  • 과부하 오류와 관련된 서버 변경의 영향을 피하기 위해 이 드라이버 버전으로 업그레이드하는 것을 권장합니다. 업그레이드하지 않은 경우 사용자 지정 재시도 노리직을 조정하여 더 높은 과부하 오류 발생 빈도를 처리합니다.

  • maxAdaptiveRetries URI 옵셕을 추가하여 SystemOverloadedError 오류로 실패하는 작업에 대해 최대 재시도 횟수를 구성합니다. 기본값은 2입니다.

  • enableOverloadRetargeting URI 옵션을 추가하여 SystemOverloadedError 의 재시도가 다른 서버를 사용하려고 하는지 여부를 제어합니다. 기본값은 false입니다.

• 초기화 후 클라이언트 핸드쉐이크 메타데이터를 클라이언트 별 또는 푸를 별로 추가하는 기능을 지원합니다.

  • C 드라이버를 랩싱하여 자가 식별하는 프로젝트에 유용한 mongoc_client_append_metadata() 및 mongoc_client_pool_append_metadata() 함수를 추가합니다.

• MONGODB-OIDC 인증의 자격 증명 제공자로 Kubernetes를 추가합니다.

개선 사항

• 클라이언트 사이드 시간 초과 시 커서 처리에 다음과 같은 개선 사항을 추가합니다.

  • 커서 클라이언트 사이드 타임아웃을 수신한 후 killCursors 를 전송합니다.

  • 반복된 클라이언트 사이드 타임아웃으로 인해 변경 스트림이 다시 시작되면 일직 종료합니다.

제거

• macOS 13 및 이전 버전에 대한 지원을 제거합니다. macOS 14 버전 이상을 사용하세요.

이 출시하다 에 대한 자세한 내용은 23v..0 출시하다 노트를 참조하세요.

수정 사항

• Windows 플랫폼에서 bson_get_monotonic_time() 의 해상도를 높입니다.

• Visual Studio 2015에 대한 지원 제거합니다. 지원되는 최소 버전은 Visual Studio 2017입니다.

지원 중단

• macOS 11 및 macOS 12에 대한 지원 중단합니다.

새로운 기능

• 다음과 같은 MONGODB-OIDC 인증 메커니즘 기능을 도입합니다.

  • mongoc_client_set_oidc_callback 및 mongoc_client_pool_set_oidc_callback를 사용한 사용자 지정 콜백 에 대한 지원 추가합니다.

  • environment:azure 속성 있는 Azure 환경에 대한 지원 추가합니다.

  • environment:gcp 속성 있는 GCP 환경에 대한 지원 추가합니다.

  • 이 출시하다 에서는 Kubernetes 환경을 지원 하지 않습니다.

• mongoc_bulkwrite_t에 다음 기능을 추가합니다.

  • mongoc_bulkwrite_is_acknowledged 함수를 추가합니다.

  • mongoc_bulkwriteresult_serverid 함수를 추가합니다.

  • Queryable Encryption 작업에 대한 지원 추가합니다.

• Queryable Encryption 에 대한 텍스트 인덱스에 대한 다음 지원 추가합니다.

  • mongoc_client_encryption_encrypt_text_opts_t 유형을 추가합니다.

  • 실험적 워크로드에 대해서만 하위 문자열, 접두사 및 접미사 검색 에 대한 미리 보기 지원 추가합니다. 이러한 기능은 불안정하며 GA(일반 사용 가능)로 출시될 때까지 보안이 보장되지 않습니다. 이러한 기능의 GA 버전은 미리 보기 버전과 이전 버전과 호환되지 않을 수 있습니다.

• Windows 보안 채널이 있는 Windows 플랫폼에서 TLS v1.3 에 대한 지원 추가합니다.

수정 사항

• 닫힌 변경 스트림 반복할 때 재개를 시도하지 않습니다.

• Visual Studio 2015에 대한 지원 제거합니다. 지원되는 최소 버전은 Visual Studio 2017입니다.

• libmongocrypt의 필수 버전을 1.13.0 에서 1.15.0으로 높입니다. 이는 사용 중 암호화 지원하며 CMake ENABLE_CLIENT_SIDE_ENCRYPTION 옵션에 해당합니다.

지원 중단

• macOS 11 및 macOS 12에 대한 지원 중단합니다.

이 출시하다 에 대한 자세한 내용은 22v..0 출시하다 노트를 참조하세요.

수정 사항

• 다음과 같은 일반적인 취약점 및 노출(CVE) 문제를 수정합니다: 옵션을 사용한 대량 쓰기 (write) 큰 옵션과 함께 전달된 경우 유효하지 않은 메모리를 읽습니다. 자세한 학습 은 관련 CVE-2025-12119 문제를참조하세요.

이 출시하다 에 대한 자세한 내용은 21v..2 출시하다 노트를 참조하세요.

수정 사항

• 더 이상 CMake 타겟에서 -fPIC 플래그를 전파하지 않습니다.

• 쓰기 (write) 명령 동작을 mongoc_collection_create_indexes_with_opts() 함수에 적용합니다.

• 단일 스레드 모니터링 명령에서 saslSupportedMechs 필드 생략합니다.

이 출시하다 에 대한 자세한 내용은 21v..1 출시하다 노트를 참조하세요.

수정 사항

• Windows가 아닌 환경의 경우 이제 제거 스크립트 find "$dir" -maxdepth 1 명령을 호출하여 macOS에서 지원되지 않았던 ls --almost-all 명령 대신 비어 있지 않은 디렉토리를 감지합니다.

• Windows 환경의 경우 제거 스크립트 더 이상 0이 아닌 잘못된 %ERRORLABEL% 값으로 "성공"하지 않습니다.

• Debian 9 및 Debian 10에 대한 지원 제거합니다.

개선 사항

• CMake 정책 최대 버전을 4.0(으)로 설정합니다. 최대 버전은 이전에 설정되지 않았습니다.

수정 사항

• Windows가 아닌 환경의 경우 이제 제거 스크립트 find "$dir" -maxdepth 1 명령을 호출하여 macOS에서 지원되지 않았던 ls --almost-all 명령 대신 비어 있지 않은 디렉토리를 감지합니다.

• Windows 환경의 경우 제거 스크립트 더 이상 0이 아닌 잘못된 %ERRORLABEL% 값으로 "성공"하지 않습니다.

• 최신 서명으로 클라이언트 인증서를 확인하기 위해 창 보안 채널 지원 추가합니다.

• rand() 사용을 스레드 세이프 대안으로 대체합니다.

• Debian 9 및 Debian 10에 대한 지원 제거합니다.

개선 사항

• 지원되는 최소 MongoDB Server 버전을 4.0 에서 4.2으로 업데이트합니다.

• CMake 정책 최대 버전을 4.0(으)로 설정합니다. 최대 버전은 이전에 설정되지 않았습니다.

• 유용하지 않은 수명이 긴 버퍼를 제거하여 메모리 사용량을 줄입니다.

• Windows API에서 생성되는 오류 메시지를 개선합니다.

수정 사항

• Windows 에서 bson_strerror_r 메시지를 수정합니다.

• Windows 보안 채널로 메모리 누수를 수정합니다.

• Windows 보안 채널에서 PKCS#8 RSA 키 로드를 수정합니다.

이 출시하다 에 대한 자세한 내용은 20v..2 출시하다 노트를 참조하세요.

수정 사항

• macOS 운영 체제에서 CMake 4 구성 오류를 수정합니다.

수정 사항

• C 운전자 보안 전송 또는 보안 채널 라이브러리를 사용하도록 구성될 때 발생하는 MONGODB-X509 인증 에 대한 사용자 이름 처리 문제를 수정합니다.

• 첫 번째 쓰기 (write) 작업 후 mongoc_bulkwrite_execute() 함수가 클라이언트 오류를 생성할 때 더 이상 mongoc_bulkwritereturn_t.res 을 부분 결과로 채우지 않습니다.

이 출시하다 에 대한 자세한 내용은 20v..1 출시하다 노트를 참조하세요.

새로운 기능

• BSON Binary Vector 하위 유형에 대한 지원 추가합니다. 자세히 학습 libbson API 문서에서 BSON 바이너리 벡터 하위 유형을 참조하세요.

새로운 기능

• 사용 중 암호화 대한 $lookup 단계를 포함하는 애그리게이션 작업을 지원합니다. 자세한 학습 은 MongoDB Server 매뉴얼에서 다음 참고 자료를 참조하세요.

  • CSFLE를 위한 $lookup 및 $graphLookup 동작

  • QE를 위한 $lookup 및 $graphLookup 동작

이 출시하다 에 대한 자세한 내용은 v.2 0 출시하다 노트를 참조하세요.

수정 사항

• 다음과 같은 일반적인 취약점 및 노출(CVE) 문제를 수정합니다: 옵션을 사용한 대량 쓰기 (write) 큰 옵션과 함께 전달된 경우 유효하지 않은 메모리를 읽습니다. 자세한 학습 은 관련 CVE-2025-12119 문제를참조하세요.

이 출시하다 에 대한 자세한 내용은 130v..6 출시하다 노트를 참조하세요.

새로운 기능

• v2.0 출시하다 새 CMake 패키지와 bson 에 대해 가져온 대상을 추가하여 CMake 프로젝트 수정하지 않고도 두 주요 버전을 모두 지원 수 있습니다.

  • 새 이름으로 bson 를 가져오려면 bson 패키지 에 대해 find_package 를 호출합니다. 새로 가져온 대상 이름은 bson::static, bson::shared 및 bson::bson입니다.

새로운 기능

• v2.0 출시하다 새 CMake 패키지와 bson 및 mongoc 에 대해 가져온 대상을 추가하여 CMake 프로젝트 수정하지 않고도 두 주요 버전을 모두 지원 수 있습니다.

  • 새 이름으로 mongoc 를 가져오려면 mongoc 패키지 에 대해 find_package 를 호출합니다. 새로 가져온 대상 이름은 mongoc::static, mongoc::shared 및 mongoc::mongoc입니다.

  • 새 이름으로 bson 를 가져오려면 bson 패키지 에 대해 find_package 를 호출합니다. 새로 가져온 대상 이름은 bson::static, bson::shared 및 bson::bson입니다.

이 출시하다 에 대한 자세한 내용은 130v..3 출시하다 노트를 참조하세요.

지원 중단

• Debian 9 및 Debian 10에 대한 지원 중단합니다.

개선 사항

• 중첩된 문서에 대한 BSON 에서 JSON 으로의 직렬화 성능 개선

수정 사항

• 더 이상 유효한 UTF-8 시퀀스를 분할 하지 않도록 bson_as_json_with_opts() 함수의 잘린 출력을 업데이트합니다.

• 다음과 같은 방법으로 생성된 JSON 텍스트를 업데이트합니다.

  • 모든 빈 배열과 문서를 하나의 공백으로 직렬화합니다.

  • 최대 재귀 제한으로 인해 운전자 생략한 배열을 { ... }대신 [ ... ] 로 직렬화합니다.

  • 레거시 CodeWScope 문서에 최대 재귀 제한을 적용합니다.

• bson_append_array_builder_begin() 함수 호출에 실패한 후 유출된 출력 매개변수를 수정합니다.

지원 중단

• Debian 9 및 Debian 10에 대한 지원 중단합니다.

새로운 기능

• 구조화된 로깅에 대한 지원 추가합니다. 이 기능 구성하려면 mongoc_client_set_structured_log_opts() 및 mongoc_client_pool_set_structured_log_opts() 함수를 사용합니다.

• 사용 중 암호화 데이터 암호화 키의 캐시 수명 구성에 대한 지원 추가합니다. 이 기능 구성하려면 mongoc_auto_encryption_opts_set_key_expiration() 및 mongoc_client_encryption_opts_set_key_expiration() 함수를 사용합니다.

  사용 중 암호화 에 대해 자세히 학습 MongoDB Server 매뉴얼에서 사용 중 암호화 참조하세요.

• 업데이트 및 바꾸기 작업을 위한 sort 옵션에 대한 지원 추가합니다.

• mongoc_bulkwrite_new() 및 mongoc_bulkwrite_set_client() 함수를 사용하여 클라이언트 없이 mongoc_bulkwrite_t 유형을 구성하기 위한 지원 추가합니다.

개선 사항

• mongoc_server_description_new_copy() 함수의 성능을 개선합니다.

수정 사항

• SDAM 사양에필요한 다음과 같은 APM 이벤트 수정이 포함되어 있습니다.

  • server_opening 이벤트 전달한 후 운전자 topology_closed를 전달하기 전에 해당 server_closed 이벤트 전달해야 합니다.

  • 운전자 topology_closed 이벤트 전달하기 전에 Unknown유형의 new_description 가 있는 topology_changed 이벤트 전달합니다.

• 클라이언트 대량 쓰기의 상세 결과에서 운전자 삽입된 문서 ID를 보고할 때 발생할 수 있는 충돌을 수정합니다.

이 출시하다 에 대한 자세한 내용은 v.1 30 출시하다 노트를 참조하세요.

지원 중단

• bson_string_t 및 관련 함수를 더 이상 사용하지 않습니다.

• 다음과 같은 컴파일을 더 이상 사용하지 않습니다. BSON_MEMCHECK

• bson_in_range_*() 및 bson_cmp_*() 함수를 더 이상 사용하지 않습니다.

• bson_atomic_*() 및 bson_thrd-yield() 함수를 더 이상 사용하지 않습니다.

• bson_as_json() 및 bson_array_as_json() 함수를 더 이상 사용하지 않습니다.

지원 중단

• mongoc_client_command을(를) 더 이상 사용하지 않습니다. 대신 mongoc_client_command_simple 을(를) 사용하세요.

• mongoc_database_command을(를) 더 이상 사용하지 않습니다. 대신 mongoc_database_command_simple 을(를) 사용하세요.

• mongoc_collection_command을(를) 더 이상 사용하지 않습니다. 대신 mongoc_collection_command_simple 을(를) 사용하세요.

이 출시하다 에 대한 자세한 내용은 v.1 29 출시하다 노트를 참조하세요.

새로운 기능

• bson_validate_with_error_and_offset() 함수 추가

새로운 기능

• 사용 중 암호화 범위 쿼리에 대한 지원 추가

• mongoc_collection_insert_one 삽입 ID 포함

• 새로운 대량 쓰기 (write) API 추가 mongoc_bulkwrite_t

• Adds serverMonitoringMode URI option

지원 중단

• *_hint 옵션을 더 이상 사용하지 않습니다. 대신 *_server_id 옵션을 사용합니다.

  • mongoc_bulk_operation_set_hint을(를) 더 이상 사용하지 않습니다. 대신 mongoc_bulk_operation_set_server_id을(를) 사용하세요.

  • mongoc_bulk_operation_get_hint을(를) 더 이상 사용하지 않습니다. 대신 mongoc_bulk_operation_get_server_id을(를) 사용하세요.

  • mongoc_cursor_set_hint을(를) 더 이상 사용하지 않습니다. 대신 mongoc_cursor_set_server_id을(를) 사용하세요.

  • mongoc_cursor_get_hint을(를) 더 이상 사용하지 않습니다. 대신 mongoc_cursor_get_server_id 을(를) 사용하세요.

• ENABLE_SSL=LIBRESSL 및 mongoc_stream_tls_libressl_new을(를) 더 이상 사용하지 않습니다.

• Windows 플랫폼에서 ENABLE_SASL=CYRUS 및 CYRUS_PLUGIN_PATH_PREFIX 옵션을 더 이상 사용하지 않습니다.

이 출시하다 에 대한 자세한 내용은 v.1 28 출시하다 노트를 참조하세요.

수정 사항

• 특수 BSON types에 대한 잘못된 확장 JSON 처리 수정

수정 사항

• Tsan 경고 수정

• C23 컴파일 수정

개선 사항

• 트랜잭션 에서 명령 오류의 예상 동작을 문서화합니다.

수정 사항

• 다음에서 큰 문자열 처리를 수정합니다. bson_append_utf8

수정 사항

• bool 또는 _Bool 가 매크로인 환경에서 발생할 수 있는 빌드 오류를 수정합니다.

수정 사항

• Visual Studio 2013의 빌드 문제를 수정합니다.

수정 사항

• 잘못된 유선 프로토콜 메시지를 읽을 때 충돌이 발생할 수 있는 문제 수정

• Visual Studio 2013의 빌드 문제를 수정합니다.

변경 사항

• 새로운 코드 서명 및 종속성 추적을 포함하여 개발 프로세스를 둘러싼 변경 사항을 소개합니다. 동작 또는 API 변경 사항은 없습니다.

수정 사항

• 번들 zlib 1.2.3 에서 1.3.1로 업그레이드

수정 사항

• 시간대의 콜론 구문 분석 수정

• 하위 문서를 초기화하지 못할 때 발생하는 오류를 수정합니다. bson_iter_visit_all

수정 사항

• 원격 서버에 대한 남은 연결을 닫습니다.

새로운 기능

• 환경 변수 MONGO_EXPERIMENTAL_SRV_PREFER_TCP 를 확인하여 SRV 조회보다 TCP를 선호합니다.

수정 사항

• bson_string_new 및 bson_string_append에서 큰 문자열 처리 수정

수정 사항

• 클라이언트 빈 비밀번호로 구성될 때 발생할 수 있는 충돌 수정

새로운 기능

• 명령 이벤트 mongoc_apm_command_failed_get_database_name 및 mongoc_apm_command_succeeded_get_database_name에 데이터베이스 이름을 추가합니다.

• 사용 중 암호화 위한 위임된 KMIP 프로토콜 지원

• 클라이언트 당 소켓 시간 초과 설정 활성화

수정 사항

• 다음 항목의 반복 수정 bson_strfreev

수정 사항

• 불완전한 데이터가 포함된 손상된 청크 사용하여 mongoc_gridfs_file_readv 을(를) 호출할 경우 중단될 수 있는 문제를 수정합니다.

• 4.2이전 MongoDB 서버 버전에 연결된 경우 레거시 배출 커서 프로토콜 로 어설트 수정

수정 사항

• 다음에 대해 정렬 할당을 사용합니다. bson_array_builder_t

수정 사항

• 32비트 컴파일을 64비트로 수정합니다. time_t

새로운 기능

• 명명된 KMS 제공자 지원

• 가능한 경우 샤딩된 클러스터의 재시도를 다른 mongos 로 리디렉션합니다.

개선 사항

• 빌드를 용이하게 하기 위해 소스에 VERSION_CURRENT 파일 추가합니다.

• 더 많은 오류를 재시도할 수 있다고 간주합니다.