リリースノート

5.8 の新機能

5.8 ドライバー リリースには、次の変更、修正、機能が含まれています。

• ベクトル検索インデックス定義㎎の型付きビルダ API を追加します。

• $rerank集計ステージのサポートを追加します。MongoDB 8.3以降を実行している Atlas クラスターに接続すると、Aggregates.rerank()ビルダ メソッドを使用してこのステージを作成できます。

• $searchパイプライン ステージでのvectorSearch演算子のサポートを追加します。SearchOperator.vectorSearch()ビルダ メソッドを使用して近似最近傍探索（ANN）ベクトル検索を実行することができます。また、SearchOperator.vectorSearchExact()を使用して厳密最近傍探索（ENN）を実行することもできます。返されるVectorSearchOperatorは、詞書プレフィルターを適用するfilter()メソッドをサポートします。

• VectorSearchIndexDefinition クラスの storedSource() メソッドを使用して、ベクトル検索インデックス定義で保存されたソースを設定するためのサポートを追加します。

• VectorSearchOptions クラスの returnStoredSource() メソッドを使用して、$vectorSearch 結果で保存されたソース フィールドのリクエストのサポートを追加します。

• 中間の割り当てを削除することで、RawBsonDocumentのエンコードとデコードのパフォーマンスを最適化します。

• Micrometer が存在しない場合の OSGi バンドル解決の失敗を修正します。

• Javadoc ドキュメントを MongodbObservation および MongodbObservationContext クラスに追加します。

• libmongocrypt バージョンを 1.18.1 にアップグレードします。

このリリースの詳細については、 Githubの v5.8 リリースノート を参照してください。

5.7 の新機能

5.7 ドライバー リリースには、次の変更、修正、機能が含まれています。

• 重要: 今後のマイナー リリースでは MongoDB Server バージョン 4.2 のサポートが削除され、サポートされる最低バージョンが 4.4 に引き上げられます。この変更は、MongoDB ソフトウェア ライフサイクル スケジュールに準拠しています。

  重大な変更に対応するために、アプリケーションに変更を加えることをお勧めします。サーバーのバージョンのアップグレードの詳細については、 MongoDB Serverマニュアルのリリースノートのセクションを参照してください。

• Scala 3 のサポートを追加しました。

• ベクトル検索 API の一部として自動埋め込みサポートを追加します。

• Reactive Streams ドライバーに Microsoft/OpenTelemetry トレースのサポートを追加し、一般的な Microsoft サポートの改善を含みます。

• Stack Overflow エラーを防ぐために、スタックセーフな非同期ループのサポートを追加します。

• ラウンドトリップ時間（RTT）のバリエーションをより考慮するようにクライアント側のタイムアウト処理が改善され、タイムアウトに関連するさまざまな小さな改善が行われます。

• 余計なサーバー選択を避けるために、ConnectionSource を再利用します。

• RawBsonDocument エンコーディングの最適化されたコーデック パスを復元し、パフォーマンスの低下を修正します。

• AsyncCommandCursor 内の空の getMore 応答間の接続を解放し、アイドル変更ストリームが maxPoolSize に達したときに接続プールが枯渇するのを防ぎます。

• 暗号化クライアントはwriteConcern過半数を使用するようになりました。

• KMS からの予期しないストリーム終了エラーを処理します。

• JsonPrimitive 数値の JsonBsonEncoder 解析を修正しました。ここでは、科学的に形式された数値は単純な Int または Longs として解析されていました。

• ServerMonitor スレッド名を簡素化し、一部のモニタリング システムでは処理できない = 文字を削除します。

• 任意の のKotlin BSONデコードを修正しました。

• libmongocrypt を 1.17.3 にアップグレードします。

• Zstandard 解凍には ZstdInputStreamNoFinalizer を使用します。

• Netty を最新バージョンに更新します。

• 最新のセキュリティ修正のために Snappy をアップデートしました。

• JRit 5 を最新バージョンに更新します。

• クラスターからサーバーを削除するときに、ログレベルを警告に合わせて調整します。

5.6 の新機能

5.6 ドライバー リリースには、次の変更、修正、機能が含まれています。

• Queryable Encryption のプレフィックス、サフィックス、サブストリング クエリの実験的なサポートを追加します。QE の詳細については、「 使用中の暗号化 」を参照してください。

  注意

  試験用機能

  Queryable Encryption のプレフィックス、サフィックス、サブストリングのクエリは不安定であり、一般提供（GA）されるまでセキュリティは保証されません。実験的なワークロードでのみ使用してください。

• ChangeStreamDocument オブジェクトに nsTypeフィールドを追加します。このフィールドには、 変更イベントの名前空間タイプ（COLLECTION、TIMESERIES、または VIEW）が含まれます。

• OIDC認証の実験的なクライアント側操作タイムアウト（COT）サポートを追加します。

  注意

  試験用機能

  COT 機能は実験的なものであり、今後のドライバー リリースで変更される可能性があります。

• COT に timeoutMS が設定されている場合、ドライバーは maxWaitTime 接続設定の値を無視します。

• MongoClientクラスに appendMetadata() メソッドを追加します。このメソッドを使用して、既存のクライアントのメタデータにメタデータを追加できます。最大メタデータサイズは 512 MB です。

• RewrapManyDataKeyOptionsクラスにパブリック コンストラクターを追加します。

• AsyncReadOperation インターフェースと AsyncWriteOperation インターフェースを ReadOperation インターフェースと WriteOperation インターフェースに統合します。Operationsクラスのビルダ メソッドを使用して、読み取り操作と書込み操作を作成できます。

• MongoNamespace.COMMAND_COLLECTION_NAME 定数を廃止します。

• セッション内で OIDC の再認証を妨げるバグを修正します。

• @BsonDiscriminator で注釈が付けられた POJO を直列化する際、プロパティの readName が弁別子キーと一致する場合、ドライバーはそのフィールドを1 回だけ直列化します。

• CommandCursorResultインスタンスで next() メソッドまたは tryNext() メソッドを呼び出すと、ドライバーは CommandCursorResult.resultsプロパティをクリアしてメモリを解放します。

• PojoBuilderHelperクラスは、抽象クラスとインターフェースのプロパティを含むプロパティモデルを作成します。

• ドライバーは、クラスターのトポロジーが変更されると、次のイベントを公開してログに記録します。

  • ClusterOpeningEvent:トポロジーが開いたときに公開

  • ClusterDescriptionChangedEvent:トポロジーの説明が変更されたときに公開

  • ClusterClosedEvent:トポロジーが閉じたときに公開

• ドライバーは、次のいずれかの理由でプライマリレプリカセットメンバーが古くなった場合、MongoStalePrimaryException をスローします。

  • 新しいプライマリ ノードが選出または検出されます。

  • プライマリ ノードの electionId または setVersionフィールドの値は、他のレプリカセットノードのこれらのフィールドの値と一致しません。

  レプリカセットの詳細については、 MongoDB Serverマニュアルのレプリケーションを参照してください。

5.5.1の新機能

5.5.1 ドライバー パッチ リリースには次の変更が含まれています。

• トランザクションで実行される操作を含む、セッションで実行される操作によってトリガーされると、OIDC 再認証が失敗する問題を修正します。

5.5 の新機能

5.5 ドライバー リリースには、次の変更、修正、機能が含まれています。

• ドライバー パフォーマンス ベンチマークに反映されるパフォーマンスの向上を導入します。パフォーマンス ベンチマーク テストの結果を表示するには、次のパフォーマンスの改善セクションを参照してください。

5.4 の新機能

5.4 ドライバー リリースには、次の変更、修正、機能が含まれています。

• 直列化中のスニペットケース変換のために bson-kotlinx に BsonConfiguration のサポートを追加します。詳細については、直列化ガイドの「スニペット ケース命名戦略の実装」セクションを参照してください。

• CSFLE と QE の $lookup 操作をサポートします。詳細については、サーバー マニュアルの次の参照を参照してください。

  • CSFLE 用の $lookup と $graphLookup の動作

  • QE の $lookup と $graphLookup の動作

• アプリケーションで使用する可能性のあるMongoDB JVMアーティファクトのバージョンを管理するための アイテムの請求書（BOM） を導入します。アプリケーションに BOM を追加する手順については、「 ダウンロードとインストール 」チュートリアルの「 ドキュメントのドライバー請求の追加 」ステップを参照してください。

• MONGODB-AWS認証メカニズムをテストするために、 Amazon Web Services SDK の依存関係を 2.30.31 と 1.12.782 に更新します。

• ClientUpdateOneOptionsClientReplaceOneOptionsクラスと クラスに並べ替えオプションを追加します。この変更により、クライアントの一括書き込みで更新操作と置換操作のソート順序を設定できるようになります。詳細については、 一括書込み操作ガイドの「 更新操作 」および「 置換操作 」のセクションを参照してください。

• OIDC認証のKubernetesサポートを追加します。詳細については、 エンタープライズ認証メカニズムガイドの「MONGODB-OIDC: Kubernetes」セクションを参照してください。

• 次のMongoDB 検索するクエリ演算子のファーストクラスのサポートを追加します。

  • phrase

  • regex

  • queryString

  • equals

  • moreLikeThis

  • in

  • wildcard

  詳細については、 集計ガイドの「MongoDB検索」セクションを参照してください。

• close() を呼び出すと、操作タイムアウトに影響せずに timeoutMS 設定を更新するようにカーソルを更新します。

• hint オプションを指定して、distinct() メソッドを呼び出すときにインデックスを使用できるようにします。

このリリースの変更の完全なリストを表示するには、 Githubの v5.4 リリースノートを参照してください。

5.3 の新機能

5.3ドライバー リリースには、次の新機能、改善点、修正が含まれています。

• 重要: 次のマイナー リリースでは、 MongoDB Serverバージョン4.0 のサポートが終了し、サポートされる最小バージョンが4.2 に引き上げられます。重大な変更に対応するために、アプリケーションに変更を加えることをお勧めします。 アップグレードの詳細については、サーバー マニュアルの「 リリースノート 」セクションを参照してください。

• ベクトルのストレージと検索用のBSONバイナリ サブタイプ 9 を実装するために BinaryVectorクラスを追加します。 このクラスは、 Double インスタンスのリストと比較して、値のより効率的なストレージを提供します。 ベクトルに含まれる要素の型に基づいて、次のベクトル型を作成できます。

  • Int8BinaryVector: 8 ビット符号付き整数のベクトル

  • Float32BinaryVector: 浮動小数点数のベクトル

  • PackedBitBinaryVector: バイナリ量子化ベクトル（ベータで、一般利用可能になるまでに変更される可能性があります）

  この機能の詳細については、Atlas ドキュメントの「 ベクトル量化 」を参照してください。 BinaryVector

• 接続プールの実装から明示的な均等性を削除します。 この変更により、多くのアプリケーションスレッドで MongoClientインスタンスを使用すると、スループットが向上する可能性があります。 ただし、この変更により 追尾レイテンシが増加する可能性があります。

• updateOne() メソッドと replaceOne() メソッドに並べ替えオプションを追加します。 この変更により、ReplaceOneModel インスタンスと UpdateOneModel インスタンスの作成時にオプションとして並べ替えを設定することもできます。 詳しくは、「 ドキュメントの更新 」、「 ドキュメントの置換 」、および「 一括書込み操作 」のガイドを参照してください。

• ビルダクラスメソッドをデータクラスプロパティで直接使用するためのサポート。詳しくは、「データ クラスでビルダを使用する」ガイドを参照してください。この機能は、このリリースで公開されたKotlin Syncドライバー拡張機能パッケージによってサポートされています。

• クライアント一括書き込みAPI を実装し、同じ呼び出しで複数のデータベースとコレクションに対して書き込み操作を実行できます。この機能の詳細については、 一括書込み操作ガイドの「 クライアント一括書込み 」セクションを参照してください。

5.2 の新機能

5.2ドライバー リリースには、次の新機能、改善点、修正が含まれています。

• クライアント側操作タイムアウト（COT）の設定を有効にします。この機能を使用すると、MongoClientインスタンスに単一のタイムアウトを設定して、そのクライアントで実行されるすべての操作に適用できます。詳細については、 「サーバー実行時間の制限」 のガイドを参照してください。

  COT 機能が有効になっている場合にのみ、次のタイムアウト オプションはドライバーによって無視されます。

  • waitQueueTimeoutMS

  • socketTimeoutMS

  • wTimeoutMS

  • maxTimeMS

  • maxCommitTimeMS

  重要

  試験用機能

  COT は実験的な機能であり、まだ本番環境には準備ができていません。この機能は現在のリリースでは任意であり、既存のタイムアウト オプションは引き続き機能します。

• SearchIndexModelインスタンス の構築時に渡すことができる SearchIndexTypeクラスを追加します。この変更により、 Atlas Search またはベクトル検索インデックス の作成時にインデックスタイプを指定できるようになります。詳細については、MongoDB Search とベクトル検索インデックスのガイドを参照してください。

• SCRAM-SHA-1とSCRAM-SHA-256認証メカニズムを実装するアルゴリズムの実装を、構成された JCA プロバイダーに委任します。 この変更により、アプリケーションは構成された FIPS 準拠の JCA プロバイダーを使用して、より高いレベルのセキュリティを提供できるようになります。

• JVMドライバーのバージョン管理と一致するように mongodb-crypt 依存関係のバージョン管理を改訂します。mongodb-crypt の将来のバージョンはドライバーと一緒にリリースされ、同じバージョン番号を共有します。mongodb-crypt の依存関係を v5.2.0 にアップグレードする必要がありますこのリリースのドライバーをアップグレードする際。詳細については、 「使用中の暗号化」ガイドを参照してください。

• サポートされているすべてのプラットフォームにネイティブ暗号化を実装ことにより、パフォーマンスが向上しました。 次のリストでは、オペレーティング システムに応じて、この改善を実装するために必要なアクションについて説明します。

  • Windows : mongodb-cryptのバージョンを v 5.2.0にアップグレードします。

  • Mac : mongodb-cryptのバージョンを v 5.2.0にアップグレードします。

  • Linux : mongodb-crypt JARファイルにバンドルされているファイルを使用する代わりに、ファイルシステムにlibmongocrypt.soを直接インストールします。 libmongocryptをインストールするためのLinux手順については、サーバー マニュアルを参照してください。 パッケージマネージャーを使用してlibmongocryptをインストールすると、 Java Native Access（JLA）は、追加の構成なしでそれを見つけます。 あるいは、 LD_LIBRARY_PATH環境変数をlibmongocryptパッケージのファイルパスに設定することで検索パスを指定できます。

    OpenSSL バイナリの互換性がない可能性があるため、バンドルされている共有ライブラリは OpenSSL にリンクされていないため、直接インストールすることをお勧めします。

    共有ライブラリのロードは JANA によって処理されます。ライブラリ検索パス順序のロードルールについては、Nativeライブラリクラスのドキュメント を参照してください。

• 状況によってはInsertOneResult.getInsertedId()メソッドとInsertManyResult.getInsertedIds()メソッドが誤ったドキュメント ID を返す問題を修正します。 この変更は、 Kotlin Sync ドライバー v 5.1.4と v 4.11.4にバックポートされます。

• シャーディングされたクラスター操作が成功しない場合、ドライバーは他のmongosサーバーが使用可能な場合、操作の再試行に同じmongosサーバーを選択しないようにします。

• アプリケーションがGraalVM Native イメージを使用するときに必要なアクセス可能性メタデータを追加します。このメタデータは、ドライバー ライブラリを使用するときに到達可能性メタデータを収集する必要があることを置き換えます。詳細については、 GraalVM ドキュメントのアクセス可能性メタデータを参照してください。

  この変更では、libjnidispatch と libmongocrypt のリソースエントリは追加されません。サポートされているすべてのプラットフォーム（ターゲット）のエントリを追加すると、 GraalVM ネイティブ イメージを使用してビルドされたネイティブ実行可能ファイルのサイズに大きく影響するためです。このサンプルresource-config.jsonファイルをドライバーGithubリポジトリで表示して、アプリケーションがorg.mongodb:mongodb-crypt ライブラリに依存している場合にこれらのエントリを明示的に指定する方法を確認します。

• VectorSearchOptions API を拡張して次の特定のオプション サブタイプを導入することで、正確なベクトル検索を有効にします。

  • ExactVectorSearchOptions: このオプション タイプを使用して完全一致を有効にし、結果が特定のクエリ ベクトルに最も近いベクトルになるようにします。

  • ApproximateVectorSearchOptions: このオプション タイプを使用すると、正確な最も近いベクトルが返されない可能性がある検索を有効にできます。 このタイプをインスタンス化するときにnumCandidatesパラメータを渡して、考慮する最近傍の数を指定できます。

  MongoDB ベクトル検索機能の使用の詳細については、 「 MongoDB ベクトル検索クイック スタート 」を参照してください。

• Kotlin の日付と時刻型を string ではなく、期待される型として BSON にマッピングできるkotlinx-datetimeライブラリのシリアライザーのサポートを追加します。 詳細については、 Kotlin 直列化 ガイドの「日付と時刻を直列化する 」セクションを参照してください。

• JsonElement 値の直列化をサポートします。JsonElement タイプを扱うには、アプリケーションに kotlinx-serialization-json ライブラリを依存関係として追加する必要があります。

5.1.3の新機能

5.1.3 ドライバー パッチ リリースには次の変更が含まれています。

• Cursor型の使用時にアサーション エラーが発生する可能性がある問題を修正しました。

5.1.2の新機能

5.1.2 ドライバー パッチ リリースには次の変更が含まれています。

• null 可能なジェネリック パラメータ型で Kotlin データ クラスをエンコードするためのサポート。 たとえば、次のコードでContainerクラスをエンコードできます。

  @Serializable
  data class Box<T>(
      val boxed: T
  )
  @Serializable
  data class Container(
      val box: Box<String?>
  )

5.1.1の新機能

5.1.1 ドライバー パッチ リリースには次の変更が含まれています。

• MONGODB-OIDC認証メカニズムを使用する場合、authMechanismProperties接続文字列値にカンマ文字を含めることはできません。 この動作の詳細については、MONGODB-OIDCガイドを参照してください。

5.1 の新機能

このセクションには、次の情報が含まれています。

• 5.1での非推奨
• 5.1での改善
• 5.1の新機能

5.0 の新機能

5.0 ドライバー リリースの新機能は次のとおりです。

• KotlinSerializerCodecProviderコンストラクターがserializersModule bsonConfigurationオブジェクトと オブジェクトを受け入れるようになりました。

  KotlinSerializerCodec.create(clazz.kotlin, serializersModule=serializersModule, bsonConfiguration=bsonConfiguration)

  これにより、構成をカスタマイズしやすくなります。

• コンテナ タイプの消去につながる Kotlin 反映バグを修正します。