リリースノート

Overview

次の新機能をご覧ください。

• バージョン4.5.3

• バージョン4.5.2

• バージョン 4.5.1

• バージョン 4.5

• バージョン 4.4

• バージョン4.3.1

• バージョン 4.3

• バージョン 4.2

• バージョン 4.1

• バージョン 4.0

• バージョン3.11

• バージョン3.10

• バージョン3.9

4.5.3の新機能

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

このリリースの詳細については、Github で v..4 5リリースノートを参照してください。3

4.5.2の新機能

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

このリリースの詳細については、Github で v..4 5リリースノートを参照してください。2

4.5.1 での新機能

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

このリリースの詳細については、Github で v..4 5リリースノートを参照してください。1

4.5 で追加された機能

4.5ドライバーリリースには、次の新機能が含まれています。

• append_metadata() メソッドを mongocxx::v1::client クラスと mongocxx::v1::pool クラスに追加します。このメソッドを使用して、クライアントまたはプールを初期化した後に、ハンドシェイク メタデータを追加します。これは、プロジェクトが C++ ドライバーをラップし、MongoDB Server に自分自身を識別する必要がある場合に便利です。

リリースには、次の削除が含まれています。

• 2025年 2015月にサポートが終了した Visual Studio のサポートを削除します。Windows で C++ ドライバーをビルドするには、Visual Studio 2017 バージョン 15.9 以降を使用します。

このリリースの詳細については、Github で v..4 5リリースノートを参照してください。0

4.4 の新機能

4.4ドライバー リリースには、次の新機能が含まれています。

• bsoncxxライブラリとmongocxxライブラリの安定ABI（v1）が本番環境で使用できるようになりました。両ライブラリのsoversionが1に設定されるようになりました。

• mongocxx::client_bulk_write クラスを介してクライアントの一括書き込み操作をサポートします。コレクションレベルの一括書き込み (mongocxx::bulk_write)とは異なり、クライアントの一括書き込みは複数のコレクションにまたがる書き込みをサポートし、同じネットワークペイロード内で挿入、更新、削除するをグループ化できます。この機能には MongoDB Server 8.0 以降が必要です。

• delete、insert、replace、bulkWrite、findOneAnd*、count、distinct の操作に readConcern オプションのサポートを追加します。

• Azure IMDS および Azure Functions/App Service Environment での MONGODB-OIDC 認証メカニズムのサポートを追加します。詳しくは、オープン ID Connect (OIDC) 認証を参照してください。

このリリースには、次の非推奨が含まれています。

• MongoDB Server 4.2 のサポートを廃止します。詳しくは、MongoDBソフトウェアライフサイクル予定 を参照してください。

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

4.3.1の新機能

4.3.1ドライバーリリースでは、次のバグが修正されます。

• 4.2.0で導入されたリグレッションを修正しますオプションが明示的にfalseに設定されている場合、findOneAnd*操作でupsertが誤ってtrueに設定されます。

このリリースの詳細については、Github で v..4 3リリースノートを参照してください。1

4.3 の新機能

4.3ドライバー リリースには、次の新機能が含まれています。

• 入力接続レート制限機能のサポートを追加します。enableOverloadRetargetingおよびmaxAdaptiveRetriesオプションを使用すると、過負荷のサーバーに接続した場合の動作を改善できます。これらの機能は、MongoDB 9.0以降を実行している Atlas クラスターで使用できます。これらのオプションについてさらに学ぶには、 「接続オプションの指定」ガイドを参照してください。

このリリースには次のバグ修正が含まれています。

• bsoncxx::vector::iterators で宣言されたクラス型の欠落しているサブスクリプト演算子を追加します。

このリリースには、次の非推奨が含まれています。

• 2025 年 10 月にサポートが終了した Visual Studio 2015 のサポートを廃止します。Visual Studio 2017 以降を使用します。

このリリースの詳細については GitHub の4 v.3 リリースノートを参照してください。

4.2 の新機能

4.2ドライバー リリースには、次の新機能が含まれています。

• C++ドライバー Stable ABI を導入しています（v1.0）実験的な使用のためのものです。この変更の一環として、不安定な ABI に大きな重大な変更が加えられました。ドライバーの v4.2 にアップグレードする場合は、アプリケーションで Stable ABI を使用するように移行することをお勧めします。

• bsonc機能 の代わりに mongocx エクスポート macx を使用して、mongocxx::v_noabi::options::index の storage_engine() const を正しくエクスポートします。

• 変更ストリームの反復処理を簡素化するために、変更ストリームヘルパー mongocxx::v1::change_stream::next() と mongocxx::v1::change_stream::try_next() を追加します。

• mongocxx::v1::text_options を通じて使用中の暗号化テキスト インデックスの実験的なサポートを追加します。

• MongoDB Server 4.2 のサポートを廃止します。詳しくは、MongoDBソフトウェアライフサイクル スケジュール を参照してください。

• macOS 11 および macOS 12 のサポートを廃止します（v4.1 では非推奨）。

• MongoDB Cドライバー 2.0.0 以降との整合性のために、<name>Config.cmake と <name>ConfigVersion.cmake パターンを使用するように CMaxパッケージ構成ファイルの名前を変更します。

• mongocxx::v_noabi::instance::current() を廃止します。次のコードに示すように、すべての mongocxx 操作で有効な非グローバルの instance 変数をインスタンス化することをお勧めします。

  int main() {
    mongocxx::instance instance;
    ...
  }

  42代替の実装については、 mongo-cxx-driverGitHubリポジトリの ドライバー. の変更ログ を参照してください。

このリリースには次のバグ修正が含まれています。

• mongocxx::result::insert_many の結果を非 ObjectId ID と比較するときに、ドライバーが誤って例外をスローする問題を修正します。

このリリースの詳細については GitHub の4 v.2 リリースノートを参照してください。

4.1 の新機能

v 4.1ドライバーのリリースには、次の新機能が含まれています。

• mongocxx::v_noabi::options::index に新しく追加された storage_engine() メソッドの storage_options() メソッドを廃止します

• BSON Binary Vector タイプのサポートを追加しました。

  詳細については、次のリソースを参照してください。

  • MongoDB Serverマニュアルの「バイナリデータ BSON types」

  • BSON バイナリ ベクトル GitHub での使用例

• v. リリースで言及されているCドライバーAPIバージョンのバグを修正しました40

• v4.0 向けに最初に公開された ENABLE_TESTS 構成のデフォルトオプションに変更を追加します。詳細については、 アップグレード ページの重大な変更の説明を参照してください。

このリリースの詳細については GitHub の4 v.1 リリースノートを参照してください。

4.0 の新機能

v 4.0ドライバーのリリースには、次の新機能が含まれています。

• mongocxx::options::change_streamインスタンスの start_at_operation_timeフィールドに getter メソッドを追加します。

このリリースには次のバグが含まれています。

• C++ドライバーのAPIバージョンが 0.0.0 に誤って設定されることがあります。CMaxプロジェクトが複数回構成されている場合、または初期構成時に BUILD_VERSION が明示的に設定されている場合は、 C++ドライバーのAPIバージョンと同じ値に設定されている場合があります。CSpec は、find_package() を使用して既存のCドライバーのインストールが見つからない場合にのみ、C++ドライバーを使用してCドライバーを自動ダウンロードします。このバグは、今後のパッチ リリースで修正される予定です。

このリリースの詳細については GitHub の4 v.0 リリースノートを参照してください。

3.11の新機能

v 3.11ドライバーのリリースには、次の新機能が含まれています。

• MongoDB Server v 8.0のサポートを追加します。

• Queryable Encryption範囲クエリのサポートを追加します。 この機能を使用するには、アプリをMongoDB Server 8.0以降に接続する必要があります。 Queryable Encryptionの詳細については、 MongoDB Serverマニュアルの「 Queryable Encryption 」を参照してください。

• mongocxx::v_noabi::bulk_writeのempty()メンバー関数を追加します。

このリリースには次のバグが含まれています。

• C++ドライバーのAPIバージョンが 0.0.0 に誤って設定されることがあります。CMaxプロジェクトが複数回構成されている場合、または初期構成時に BUILD_VERSION が明示的に設定されている場合は、 C++ドライバーのAPIバージョンと同じ値に設定されている場合があります。CSpec は、find_package() を使用して既存のCドライバーのインストールが見つからない場合にのみ、C++ドライバーを使用してCドライバーを自動ダウンロードします。このバグは、今後のパッチ リリースで修正される予定です。

このリリースの詳細については GitHub の3 v.11 リリースノートを参照してください。

3.10の新機能

The v 3.10.0 ドライバー リリースには、次の新機能が含まれています。

• bsoncxxおよびmongocxxクラスタイプの非定義宣言を提供するフォワード ヘッダーを追加します。 ドライバーは、ライブラリ エンティティのユーザー定義によるフォワード宣言をサポートしていません。 ライブラリ エンティティの宣言または定義を取得するには、対応する ヘッダーを常に含めます。

• CSpec オプションENABLE_BSONCXX_USE_POLY_IMPLSを使用すると、ポリゴン ライブラリが要求されていない場合に、デフォルトでC++ 17ポリゴンのbsoncxx実装を選択できます。 このオプションはデフォルトでOFFです。

• CMax オプションBSONCXX_POLY_USE_IMPLSを使用すると、外部ライブラリまたはC++標準ライブラリの代わりに、 C++ 17ポリゴンのbsoncxx実装を選択できます。 このオプションはデフォルトでOFFです。

• bsoncxx::v_noabiとmongocxx::v_noabiの名前空間は、インラインで宣言されなくなりました。 ルート名前空間宣言は引き続きサポートされ、以前の定義と同等であることが予想されます。 例、 bsoncxx::documentは依然としてbsoncxx::v_noabi::documentと同等であり、 mongocxx::clientは引き続きmongocxx::v_noabi::clientと同等です。

• デフォルトでは 、ライブラリのファイル名が MSV でコンパイルされると（CSpec の MSVC 変数によって検出）、ABI タグstringが埋め込まれます。 これらの文字列は次のようになります。

  bsoncxx-v_noabi-rhs-x64-v142-md.lib

  この動作を無効にするには、CSpec 構成の一部としてENABLE_ABI_TAG_IN_LIBRARY_FILENAMES=OFFを設定します。

  ABI タグ string は、次のように pkg-configメタデータファイル名に埋め込むこともできます。

  libbsoncxx-v_noabi-rhs-x64-v142-md.pc

  この動作を有効にするには、CMax 構成の一部としてENABLE_ABI_TAG_IN_LIBRARY_FILENAMES=ONとENABLE_ABI_TAG_IN_PKGCONFIG_FILENAMES=ONを設定します。

このリリースの詳細については GitHub の3 v.10 リリースノートを参照してください。

3.9の新機能

v 3.9ドライバーのリリースには、次の新機能が含まれています。

• C++ ドライバー コンテナ イメージが Docker hub で利用可能になりました。

• MongoDB C ドライバーの依存関係を指定しない場合、ドライバーは自動的にMongoDB Cドライバーの依存関係をダウンロードします。

• ドライバーは、 allターゲットの一部としてテストをビルドしなくなりました。 テストを構築するには、CSpec 構成の一部としてBUILD_TESTING=ONを設定します。

• FetchContentドライバーは、システムによって提供されていない場合は、 モジュールではなく、ExternalProject モジュールを使用して MNMLSTC コア ポリゴンinclude ライブラリをダウンロードして構築します。また、MNMLSTC Core ヘッダーの ディレクティブもパッチされません。

• CMax オプションMONGOCXX_OVERRIDE_DEFAULT_INSTALL_PREFIXを追加します。 このオプションがTRUEに設定されている場合、 CMAKE_INSTALL_PREFIXオプションはデフォルトでビルドディレクトリになります。 このオプションのデフォルト値はTRUEです。

• MongoDB 検索インデックスを管理するためのAPIを追加します。

• VERSIONINFOリソースをbsoncxx.dllとmongocxx.dllに追加します。

• APMコールバックから例外をスローするドキュメントは、明示的に未定義の動作です。

• CMax ビルド ステップ中に MNMLSTC コア ヘッダーを早期インストールしません。

• インストールされたすべてのC++ドライバーパッケージ構成で、 MongoDB Cドライバー CMaxパッケージがfind_dependency()経由で見つかる必要があります。

このリリースの詳細については GitHub の3 v.9 リリースノートを参照してください。