新機能

5.2 の新機能

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

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

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

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

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

  • 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 ネイティブ イメージを使用してビルドされたネイティブ実行可能ファイルのサイズに大きく影響するためです。 このサンプル リソース-config.json を 表示Github アプリケーションが ライブラリに依存している場合に、これらのエントリを明示的に指定する方法を確認するには、ドライバー リポジトリのorg.mongodb:mongodb-crypt ファイルを参照してください。

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

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

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

  Atlas Vector Search 機能の使用の詳細については、 Atlas Vector Search クイック スタートを参照し、言語ドロップダウンから Kotlin (Sync)を選択してください。

• 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 接続string値にカンマ文字を含めることはできません。

5.1 の新機能

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

• 5.1での非推奨

• 5.1での改善

• 5.1の新機能

5.0 の新機能

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

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

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

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

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