新機能

5.3 の新機能

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

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

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

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

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

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

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

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

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

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

5.2 の新機能

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

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

  重要

  非推奨のタイムアウト オプション

  次のタイムアウト オプションは非推奨です。

  • waitQueueTimeoutMS

  • socketTimeoutMS

  • wTimeoutMS

  • maxTimeMS

  • maxCommitTimeMS

  これらのオプションの機能を置き換えるには、CSO 機能を使用します。

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

• 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 を返す問題を修正します。 この変更はJava Reactive Streams ドライバー 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パラメータを渡して、考慮する最近傍の数を指定できます。

  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 の新機能

v 5.1で導入されたその他の変更については、 Java Sync Driver のドキュメントの 「新機能」ガイドを参照してください。