릴리스 노트

2.25의 새로운 기능

Ruby 드라이버 2.25 출시에는 다음과 같은 새로운 기능, 변경 사항 및 버그 수정이 포함됩니다.

• 사용 중 암호화에 다음 기능을 추가합니다.

  • 사용 중 암호화가 활성화된 컬렉션을 참조하는 집계 파이프라인에서 $lookup 을 사용하는 기능을 추가합니다.

  • Queryable Encryption 컬렉션의 암호화된 필드 맵을 정의할 때 keyId 대신 keyAltName 필드를 사용하여 데이터 키를 지정할 수 있습니다.

  • KMIP 마스터 키의 delegated 옵션 지원을 추가합니다. true로 설정하면 KMIP 서버가 데이터 키를 암호화 및 복호화하므로 키 암호화 키가 서버를 벗어나지 않습니다.

  • type:name 형식을 사용하는 명명된 KMS 제공자에 대한 지원을 추가합니다.

  • mongocrypt_kms_ctx_fail 이 false을 반환할 때 발생하는 오류를 래핑합니다.

• 명령 응답에서 커서를 만드는 Database#cursor_command 메서드를 추가합니다.

• Mongo::Client에 설정된 경우 레거시 재시도 조정 옵션 :max_read_retries, :read_retry_interval, :max_write_retries 가 더 이상 사용되지 않습니다. 이 옵션은 더 이상 사용되지 않는 레거시 재시도 기능에만 적용됩니다. 현대적인 재시도 가능한 읽기 및 쓰기 (write)는 기본값으로 활성화되며 이 옵션은 무시됩니다.

• tls 또는 ssl URI 옵션에 잘못된 불리언 값을 전달하면 오류가 발생합니다.

• mongocrypt_kms_ctx_fail 이 false을 반환할 때 발생하는 오류를 래핑합니다.

• URI 렌더링 및 Mongo::Error::InvalidURI 오류 메시지에서 자격 증명을 음영합니다.

• SRV 모니터 스레드를 보호하고 raise_on_invalid 옵션 처리를 수정합니다.

• 로드 밸런싱 토폴로지에서의 연결 누수 문제를 해결합니다.

• 서버 선택 사양을 준수하도록 secondaryPreferred 읽기 설정 (read preference) 동작을 수정합니다.

• 이를 통해 일직 가밀리집을 방지하기 위해 Binary.wrap_string 에서 MemoryPointer 객체를 유지합니다.

• 모니터의 왕복 시간 검사에서 SDAM 이벤트 게시를 중단합니다.

• 원인적으로 일관적인 세션에서 쓰기 (write)에 afterClusterTime 을(를) 보냅니다.

• 네트워크 오류로 인해 서버가 Unknown 으로 표시되면 모니터링 연결을 닫습니다.

• 검색 인덱스 헬퍼 명령에 대한 읽기 및 쓰기 고려 (write concern)를 추가하는 것을 중지합니다.

이 릴리스에 대해 자세히 알아보려면 Github에서 v2.25.0 릴리스 노트를 참조하세요.

2.24.1의 새로운 기능

Ruby 드라이버 2.24.1 출시에는 다음과 같은 새로운 기능, 변경 사항 및 버그 수정이 포함됩니다.

• OpenTelemetry 추적이 중요 명령을 캡처하지 못하도록 방지합니다.

• 기본값이 false인 Mongo::Config.include_server_address_in_errors 옵션을 추가합니다. 활성화되면 Mongo::Error::OperationFailure 및 Mongo::Error::BulkWriteError 메시지에는 오류를 생성한 서버의 호스트와 포트가 포함됩니다.

• 명령 모니터링 사양에 따라 명령 이벤트에 databaseName 속성을 추가합니다.

• 스냅샷 세션에서 atClusterTime 를 노출합니다.

이 릴리스에 대해 자세히 알아보려면 Github에서 v2.24.1 릴리스 노트를 참조하세요.

2.24의 새로운 기능

Ruby 드라이버 2.24 출시에는 다음과 같은 새로운 기능, 변경 사항 및 버그 수정이 포함됩니다.

• :server_monitoring_mode 연결 옵션을 도입합니다. 자세한 학습 은 연결 옵션 가이드 의 서버 선택 섹션을 참조하세요.

• 수신 연결 속도 제한 기능에 대한 지원 추가합니다. :enable_overload_retargeting 및 :max_adaptive_retries 옵션을 사용하여 오버로드된 서버에 연결할 때 동작을 개선할 수 있습니다. 이러한 옵션에 대해 자세히 학습하려면 연결 옵션 가이드의 읽기 및 쓰기 (write) 작업 섹션을 참조하세요.

• MongoDB Intelligent 워크로드 관리(IWM)을 지원합니다. Ruby 드라이버는 이제 쓰기 (write) 차단 시나리오를 원활하게 처리하고 고부하 상태에서 연결 설정을 최적화하여 애플리케이션 가용성을 유지합니다. IWM에 대해 자세히 학습하려면 Atlas 문서의 쓰기 (write) 차단 을 참조하세요. 이 기능은 MongoDB 9.0 이상을 실행하는 Atlas 클러스터에서 사용할 수 있습니다.

이 출시하다 에 대해 자세히 학습 Github 의 v2.24 릴리스 노트 참조하세요.

2.23의 새로운 기능

Ruby 드라이버 2.23 출시에는 다음과 같은 새로운 기능, 변경 사항 및 버그 수정이 포함됩니다.

• OpenTelemetry로 드라이버 작업 추적에 대한 지원을 추가합니다. 이 기능 활성화하면 Ruby 드라이버 작업과 해당 서버 명령을 추적합니다. tracing 옵션을 true로 설정하여 Mongo::Client 인스턴스 에서 추적을 활성화 하거나 OTEL_RUBY_INSTRUMENTATION_MONGODB_ENABLED 환경 변수를 통해 전역으로 설정하다 수 있습니다.

• 클라이언트 사이드 필드 레벨 암호화 (CSFLE) 유형을 Ruby 유형으로 변환하기 위한 csfle_convert_to_ruby_types 구성 옵션을 추가합니다.

• 클라이언트 메타데이터 로그의 플랫폼 필드 에 Ruby 엔진 ( 예시 : TruffleRuby 또는 JRuby)을 추가합니다.

• 레이블이 3개 미만인 유효한 호스트 이름을 사용하는 SRV 연결 문자열을 허용합니다.

• srv_max_hosts URI 옵션을 올바르게 구현합니다.

• Ruby 4.0에 대한 지원 추가합니다.

• 0(무한) 및 양수 시간 초과 값을 올바르게 처리하여 with_transaction 에서 클라이언트 사이드 작업 시간 초과(CSOT) 처리를 수정합니다.

이 출시하다 에 대해 자세히 학습 Github 의 v2.23 릴리스 노트 참조하세요.

2.22의 새로운 기능

Ruby 드라이버 2.22 릴리스에는 다음과 같은 새로운 기능, 변경 사항 및 개선 사항이 포함되어 있습니다.

• update_one 및 replace_one 메서드에 대한 정렬 옵션을 추가합니다. 자세한 내용은 update_one 및 replace_one에 대한 API 설명서를 참조하세요.

• 연결 풀 체크아웃 중 SocketError 처리에 재시도 로직을 추가합니다.

• 서버 unknown(으)로 표시될 때 발생한 ArgumentError 를 수정합니다.

이 출시하다 에 대해 자세히 학습 Github 의 v2.22 릴리스 노트 참조하세요.

2.21.1의 새로운 기능

Ruby 운전자 2.21.1 출시하다 에는 다음과 같은 새로운 기능, 변경 사항 및 개선 사항이 포함되어 있습니다.

• Mongo::SearchIndex::View#create_one 및 Mongo::SearchIndex::View#create_many 검색 인덱스 생성 메서드에 type 매개 변수를 추가합니다. 이를 통해 프로그래밍 방식으로 MongoDB Vector Search 검색 인덱스를 생성할 수 있습니다. 자세한 내용을 학습 예시를 보려면 MongoDB 검색 및 MongoDB 벡터 검색 인덱스 가이드 를 참조하세요.

• Ruby 3.3과의 호환성을 추가합니다. 자세한 학습 은 호환성을 참조하세요.

2.21의 새로운 기능

Ruby 운전자 2.21 출시하다 다음과 같은 새로운 기능이 포함되어 있습니다.

• 대부분의 시간 초과 관련 옵션을 단일 timeout_ms 옵션으로 통합하는 CSOT(클라이언트 측 작업 시간 초과) 기능 지원합니다.

• MongoDB Server 버전 8.0을 지원합니다.

• 새로운 trim_factor 매개 변수를 포함하여 Queryable Encryption 사용하는 범위 v2 쿼리를 지원합니다. Queryable Encryption 에 대한 자세한 내용은 MongoDB Server 매뉴얼의 Queryable Encryption 참조하세요.

이 출시하다 에 대해 자세히 학습 Github 의 v2.21 릴리스 노트 참조하세요.

2.20의 새로운 기능

Ruby 운전자 2.20 출시하다 다음과 같은 새로운 기능이 포함되어 있습니다.

• Ruby 2.5 및 2.6에 대한 지원 중단합니다. 다음 마이너 운전자 버전에서 중단될 Ruby 2.7 및 JRuby 9.2에 대한 지원 중단합니다. JRuby 9.4에 대한 지원 추가합니다.

• 새로 출시된 Ruby- BSON 버전 5.0을 지원합니다.

• 호스트와 옵션 사이에 슬래시 없이 연결 문자열을 허용합니다. 예시 를 들어 mongodb://example.com?w=1 및 mongodb://example.com/?w=1 은(는) 이제 모두 유효한 연결 문자열입니다.

• 분석 목적으로 클라이언트 환경에 대한 컨테이너 런타임 및 오케스트레이션 메타데이터 서버 로 전송합니다.

• 호스팅하다 CosmosDB(Azure) 또는 DocumentDB(Amazon) 인스턴스 로 감지할 때 로그 에 경고 메시지를 기록합니다.

• 가능한 경우 샤딩된 토폴로지 의 다른 mongos 인스턴스 에서 읽기 또는 쓰기 (write) 작업을 재시도합니다.

이 출시하다 에 대해 자세히 학습 Github 의 v2.20 릴리스 노트 참조하세요.