新機能
次の新機能をご覧ください。
5.5.1の新機能
5.5.1 ドライバー パッチ リリースには次の変更が含まれています。
トランザクションで実行される操作を含む、セッションで実行される操作によってトリガーされると、OIDC 再認証が失敗する問題を修正します。
5.5 の新機能
重要
MongoDB Server 4.0 のサポートの削除
Kotlin Syncドライバー v5.5 はMongoDB Server 4.0 のサポートを廃止します。 サーバーの互換性のあるバージョンの詳細については、「 互換性 」を参照してください。
5.5 ドライバー リリースには、次の変更、修正、機能が含まれています。
ドライバー パフォーマンス ベンチマークに反映されるパフォーマンスの向上を導入します。パフォーマンス ベンチマーク テストの結果を表示するには、次のパフォーマンスの改善セクションを参照してください。
パフォーマンスの向上
このセクションの表は、同期Javaドライバーのパフォーマンス テストの結果を示しています。テストは、次の構成のMongoDB Server 8.0 配置で実行されました。
localhost
で実行中のネットワークレイテンシは無視できます。高レイテンシの環境では、パフォーマンスの大きな改善は見られない可能性があります。認証が無効になっています。
TLS が無効になっています。
すべてのMongoDB Javaドライバーでも、改善された driver-core
APIを共有しているため、同様のパフォーマンス向上が予想されます。
標準トランスポート設定
次の表は、標準のトランスポート設定で構成されたドライバーの v5.5 のパフォーマンス テストの結果を示しています。各行には、テストされた機能、パフォーマンスの割合の改善、および z スコア が含まれます。
機能 | 改善率 | Z スコア |
---|---|---|
BSON深度デコード | 19.44% | 5.4 |
ディープBSONエンコーディング | 102% | 22.8 |
多数を検索し、カーソルを空にする | 25.08% | 13.72 |
IDで 1 つを検索 | 2.7% | 3.16 |
平面BSONデコード | 31.2% | 9.38 |
平面BSONエンコーディング | 199.5% | 12.34 |
BSON の完全なデコード | 16.5% | 7.23 |
BSONでの完全なエンコーディング | 147.3% | 10.39 |
JSON- LD マルチファイルのインポート | 21.8% | 8.21 |
大規模なドキュメントを含むクライアント一括挿入 | 91.3% | 24.44 |
大規模なドキュメントを含むコレクションの一括挿入 | 96.5% | 8.79 |
大きなドキュメントの一括挿入 | 93.3% | 8.11 |
小さなドキュメントの一括挿入 | 39.3% | 5.72 |
大きなドキュメントを持つ 1 つを挿入 | 82.4% | 7.28 |
小さなドキュメントを含むクライアント一括挿入 | 49.5% | 17.99 |
小さなドキュメントを含むコレクションの一括挿入 | 47.8% | 6.44 |
Netty Transport Settings
次の表は、Netty トランスポート設定で構成されたドライバーの v5.5 に対するパフォーマンス テストの結果を示しています。各行には、テストされた機能、パフォーマンスの割合の改善、および z スコア が含まれます。
機能 | 改善率 | Z スコア |
---|---|---|
多数を検索し、カーソルを空にする | 40.3% | 14.81 |
IDで 1 つを検索 | 4.4% | 4.12 |
JSON- LD マルチファイルのインポート | 16.9% | 3.77 |
大規模なドキュメントを含むクライアント一括挿入 | 54.8% | 14.49 |
大規模なドキュメントを含むコレクションの一括挿入 | 104.9% | 38.72 |
大きなドキュメントの一括挿入 | 74.6% | 65.55 |
大きなドキュメントを持つ 1 つを挿入 | 66.6% | 58.65 |
小さなドキュメントを含むクライアント一括挿入 | 36.1% | 15.41 |
小さなドキュメントを含むコレクションの一括挿入 | 39.3% | 37.38 |
小さなドキュメントの一括挿入 | 35.1% | 41.51 |
Tip
ドライバー パフォーマンス ベンチマーク テストの方法の詳細については、 パフォーマンス ベンチマーク の仕様 を参照してください。
5.4 の新機能
5.4 ドライバー リリースには、次の変更、修正、機能が含まれています。
直列化中のスニペットケース変換のために
bson-kotlinx
にBsonConfiguration
のサポートを追加します。詳細については、直列化ガイドの「スニペット ケース命名戦略の実装」セクションを参照してください。
CSFLE と QE の
$lookup
操作をサポートします。詳細については、サーバー マニュアルの次の参照を参照してください。アプリケーションで使用する可能性のあるMongoDB JVMアーティファクトのバージョンを管理するための アイテムの請求書(BOM) を導入します。アプリケーションに BOM を追加する手順については、「 ダウンロードとインストール 」チュートリアルの「 ドキュメントのドライバー請求の追加 」ステップを参照してください。
MONGODB-AWS
認証メカニズムをテストするために、 Amazon Web Services SDK の依存関係を 2.30.31 と 1.12.782 に更新します。ClientUpdateOneOptions
クラスとClientReplaceOneOptions
クラスに並べ替えオプションを追加します。この変更により、クライアントの一括書き込みで更新操作と置換操作のソート順序を設定できるようになります。詳細については、 一括書込み操作ガイドの「更新操作」および「置換操作」のセクションを参照してください。OIDC認証のKubernetesサポートを追加します。詳細については、 エンタープライズ認証メカニズムガイドの「MONGODB-OIDC: Kubernetes」セクションを参照してください。
次の Atlas Search クエリ演算子のファーストクラスのサポートを追加します。
phrase
regex
queryString
equals
moreLikeThis
in
wildcard
詳細については、 集計ガイドの「Atlas Search」セクションを参照してください。
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 APIドキュメントを参照してください。
接続プールの実装から明示的な均等性を削除します。 この変更により、多くのアプリケーションスレッドで
MongoClient
インスタンスを使用すると、スループットが向上する可能性があります。 ただし、この変更により 追尾レイテンシが増加する可能性があります。updateOne()
メソッドとreplaceOne()
メソッドに並べ替えオプションを追加します。 この変更により、ReplaceOneModel
インスタンスとUpdateOneModel
インスタンスの作成時にオプションとして並べ替えを設定することもできます。 詳しくは、「 ドキュメントの更新 」、「 ドキュメントの置換 」、および「 一括書込み操作 」のガイドを参照してください。
ビルダクラスメソッドをデータクラスプロパティで直接使用するためのサポート。 詳しくは、「 データ クラスでビルダを使用する 」ガイドを参照してください。この機能は、このリリースで公開されたKotlin Syncドライバー拡張機能パッケージによってサポートされています。
クライアント一括書き込みAPI を実装し、同じ呼び出しで複数のデータベースとコレクションに対して書き込み操作を実行できます。この機能の詳細については、 一括書込み操作ガイドの「 クライアント一括書込み 」セクションを参照してください。
5.2 の新機能
重要
MongoDB Server 3.6 のサポートの削除
Kotlin Syncドライバー v5.2 はMongoDB Server 3.6 のサポートを廃止します。 サーバーの互換性のあるバージョンの詳細については、「 互換性 」を参照してください。
5.2ドライバー リリースには、次の新機能、改善点、修正が含まれています。
クライアント側操作タイムアウト(COT)の設定を有効にします。この機能を使用すると、
MongoClient
インスタンスに単一のタイムアウトを設定して、そのクライアントで実行されるすべての操作に適用できます。詳細については、 「サーバー実行時間の制限」 のガイドを参照してください。重要
非推奨のタイムアウト オプション
次のタイムアウト オプションは非推奨です。
waitQueueTimeoutMS
socketTimeoutMS
wTimeoutMS
maxTimeMS
maxCommitTimeMS
これらのオプションの機能を置き換えるには、CSO 機能を使用します。
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にアップグレードする必要があります。 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 ネイティブ イメージを使用してビルドされたネイティブ実行可能ファイルのサイズに大きく影響するためです。 このサンプル リソース-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
クラスをエンコードできます。data class Box<T>( val boxed: T ) data class Container( val box: Box<String?> )
5.1.1の新機能
5.1.1 ドライバー パッチ リリースには次の変更が含まれています。
MONGODB-OIDC
認証メカニズムを使用する場合、authMechanismProperties
接続string値にカンマ文字を含めることはできません。
5.1 の新機能
警告
このリリースの廃止
ドライバーの将来のメジャー リリースで重大な変更を避けるため、非推奨のプログラム要素に依存するアプリケーション コードをすべて置き換えます。
このセクションには、次の情報が含まれています。
5.1での非推奨
MongoDB Server v 3.6のサポートは非推奨であり、次のドライバー バージョンのリリースで削除される予定です。 MongoDB Server 配置をアップグレードする方法については、MongoDB Server マニュアルのリリースノートを参照してください。
5.1での改善
GraalVM ネイティブ イメージ テクノロジーの内部テスト。 これらのテストには、 GraalVM ネイティブ イメージ ツールを使用してネイティブ アプリケーションをビルドすることが含まれます。
MONGODB-OIDC
認証メカニズムのサポートが強化されました。
多形の
MongoCollection
インスタンスの使用時に操作で誤ったコーデックが使用される問題を修正しました。 これにより、bson-kotlinx
を使用するときに弁別子情報が失われることがなくなります。多形の
MongoCollection
インスタンスを使用する際に、クラス弁別子がデコード中の最初のフィールドであり、フィールド型エラーが発生する問題を修正します。
5.1の新機能
多態的な 直列化 のサポート。 詳細については、 Kotlin 直列化 ガイドの「多形直列化」セクションを参照してください。
serverMonitoringMode
接続 URI オプションを導入します。 詳細については、「接続オプションの指定 」ガイドを参照してください。
5.0 の新機能
5.0 ドライバー リリースの新機能は次のとおりです。
KotlinSerializerCodecProvider
コンストラクターがserializersModule
bsonConfiguration
オブジェクトと オブジェクトを受け入れるようになりました。KotlinSerializerCodec.create(clazz.kotlin, serializersModule=serializersModule, bsonConfiguration=bsonConfiguration) これにより、構成をカスタマイズしやすくなります。
コンテナ タイプの消去につながる Kotlin 反映バグを修正します。