새로운 기능

5.2의 새로운 기능

5.2 운전자 출시하다 에는 다음과 같은 변경 사항, 수정 사항 및 기능이 포함됩니다.

• 인스턴스 를 구성할 때 전달할 수 있는 클래스를 SearchIndexType SearchIndexModel 추가합니다. 이 변경 사항을 통해 Atlas Search 또는 Vector Search 인덱스 를 생성할 때 인덱스 유형을 지정할 수 있습니다. 학습 내용은 SearchIndexModel API 설명서를 참조하세요.

• SCRAM-SHA-1 및 SCRAM-SHA-256 인증 메커니즘을 구현 하는 알고리즘 구현 을 구성된 JCA 제공자 에게 위임합니다. 이 변경은 애플리케이션 에서 구성된 FIPS 호환 JCA 제공자 를 사용하여 더 높은 수준의 보안을 제공할 수 있음을 의미합니다.

• mongodb-crypt 수정 종속성 버전을 사용하여 JVM 드라이버의 버전과 일치시킵니다. mongodb-crypt 의 향후 버전은 운전자 와 함께 출시될 예정이며 동일한 버전 번호를 주식 합니다. mongodb-crypt 종속성을 v5 로 업그레이드 해야 합니다.2.0 이 출시하다 의 운전자 를 업그레이드할 때 . 학습 내용은 사용 중 암호화 가이드 를 참조하세요.

• 지원되는 모든 플랫폼에서 네이티브 암호화를 구현 하여 성능이 향상되었습니다. 다음 목록에서는 운영 체제에 따라 이 개선 사항을 구현 하는 데 필요한 조치를 설명합니다.

  • Windows: mongodb-crypt 버전을 v5.2.0 로 업그레이드합니다.

  • Mac: mongodb-crypt 버전을 v5.2.0 으로 업그레이드합니다.

  • Linux: mongodb-crypt JAR 파일 에 번들로 제공되는 파일 을 사용하는 대신 파일 시스템에 직접 libmongocrypt.so 를 설치합니다. libmongocrypt 설치에 대한 Linux 지침은 서버 매뉴얼 에서 찾을 수 있습니다. 패키지 관리자를 사용하여 libmongocrypt 를 설치하는 경우 추가 구성 없이 JNA( Java Native Access)가 해당 위치를 찾습니다. 또는 LD_LIBRARY_PATH 환경 변수를 libmongocrypt 패키지 의 파일 경로로 설정하여 검색 경로를 지정할 수 있습니다.

    번들로 제공되는 공유 라이브러리는 OpenSSL 바이너리 비호환성 가능성으로 인해 OpenSSL과 연결되지 않으므로 직접 설치를 권장합니다.

    공유 라이브러리 로딩은 JNA에서 처리합니다. 라이브러리 로딩 검색 경로 순서에 대한 규칙은 NativeLibrary 클래스 문서에서 확인할 수 있습니다.

• 일부 상황에서 InsertOneResult.getInsertedId() 및 InsertManyResult.getInsertedIds() 메서드가 잘못된 문서 ID를 반환하는 문제를 수정합니다. 이 변경 사항은 Java Reactive Streams 운전자 v5.1.4 및 v4.11.4 에 백포트되었습니다.

• 샤딩된 클러스터 작업이 실패하면 운전자 는 다른 mongos 서버를 사용할 수 있는 경우 작업 재시도를 위해 동일한 mongos 서버 를 선택하지 않습니다.

• 애플리케이션 에서 GraalVM 네이티브 이미지를 사용할 때 필요한 연결 가능성 메타데이터 를 추가합니다. 이 메타데이터 는 운전자 라이브러리를 사용할 때 연결 가능성 메타데이터 를 수집할 필요성을 대체합니다. 학습 내용은 연결 가능성 메타데이터 를 참조하세요. GraalVM 문서에서 확인 가능합니다.

  지원되는 모든 플랫폼(대상)에 대한 항목을 추가하면 GraalVM 네이티브 이미지를 사용하여 빌드된 네이티브 실행 파일의 크기에 큰 영향을 미치기 때문에 이 변경으로 인해 libjnidispatch 및 libmongocrypt 리소스 항목이 추가되지 않습니다. 이 샘플 리소스-config.json 보기 파일 을 운전자 리포지토리 에서 확인하여 Github 애플리케이션 이 라이브러리에 의존하는 경우 이러한 항목을 명시적으로 지정하는 방법을 org.mongodb:mongodb-crypt 확인합니다.

• VectorSearchOptions API 를 확장하여 다음과 같은 특정 옵션 하위 유형을 도입하여 정확한 벡터 검색 을 활성화합니다.

  • ExactVectorSearchOptions: 이 옵션 유형을 활성화 정확한 일치가 활성화되어 결과가 지정된 쿼리 벡터에 가장 가까운 벡터가 됩니다.

  • ApproximateVectorSearchOptions: 정확히 가장 가까운 벡터를 반환하지 않을 수 있는 검색을 활성화 하려면 이 옵션 유형을 사용합니다. 이 유형을 인스턴스화할 때 numCandidates 매개변수를 전달하여 고려해야 할 가장 가까운 이웃의 수를 지정할 수 있습니다.

  Atlas Vector Search 기능 사용에 학습 보려면 Atlas Vector Search 빠른 시작 을 참조하세요.

5.1.3의 새로운 기능

5.1.3 운전자 패치 출시하다 에는 다음과 같은 변경 사항이 포함됩니다.

• Cursor 유형을 사용할 때 어설션 오류를 일으킬 수 있는 문제를 수정합니다.

5.1.2의 새로운 기능

5.1.2 운전자 패치 출시하다 에는 다음과 같은 변경 사항이 포함됩니다.

• 기본 클래스를 MongoCollection 인스턴스 의 일반 유형으로 지정하는 경우 운전자 가 일반 기본 클래스를 확장하는 구체적인 클래스를 인코딩 및 디코딩하지 못하는 문제를 수정합니다.

5.1.1의 새로운 기능

5.1.1 운전자 패치 출시하다 에는 다음과 같은 변경 사항이 포함됩니다.

• MONGODB-OIDC 인증 메커니즘 을 사용하는 경우 authMechanismProperties 연결 string 값에 쉼표 문자를 포함하지 않아야 합니다.

5.1의 새로운 기능

v5.1 에 도입된 다른 변경 사항에 학습 보려면 설명서 의 새로운 기능 가이드 Java Sync Driver 를 참조하세요.