ドライバーのバージョンをアップグレードする

項目一覧

Overview

このページでは、 C++ドライバーの新しいバージョンにアップグレードするときにアプリケーションに加える必要がある変更について説明します。

アップグレードする前に、次のアクションを実行してください。

新しいC++ドライバーのバージョンが、アプリケーションが接続するMongoDB Serverのバージョンと、アプリケーションがコンパイルされるC++標準バージョンと互換性があることを確認します。バージョンの互換性情報については、 C++ドライバーの互換性ページを参照してください。
アプリケーションが使用しているドライバーバージョンと計画されているアップグレードバージョン間の重大な変更については、重大な変更セクションを参照してください。

ドライバーのバージョンをアップグレードするときにMongoDB Serverのバージョン間で互換性を確保するには、 Stable APIを使用します。

C++ドライバーはセマンティックバージョン管理に従います。ドライバーは、どのリリースでもビルドシステムまたはパッケージの互換性を中断する可能性があります。パッチリリースにより、誤ってAPI重大な変更が元に戻る可能性があります。

重大な変更とは、ドライバーの特定のバージョン以降の規則または動作の変更です。このタイプの変更では、ドライバーをアップグレードする前に対処しないと、アプリケーションが正常に動作しなくなる可能性があります。

このセクションの重大な変更は、それを導入したドライバーのバージョンによって分類されます。ドライバーのバージョンをアップグレードするときは、現在のバージョンとアップグレードのバージョン間のすべての重大な変更に対処してください。

C++ドライバーをバージョン3.0からバージョン3.10にアップグレードする場合は、バージョン3.1から3.10にリストされているすべての重大な変更に対処します。

MongoDB Server v 3.6のサポートを廃止します。
MongoDB Cドライバー v 1.28.0以降が必要です。
bsoncx ABI 内の次のプライベートノード関数のエクスポートを削除します。
- bsoncxx::v_noabi::types::bson_value::value::value(const uint8_t*, uint32_t, uint32_t, uint32_t)
- bsoncxx::v_noabi::types::bson_value::view::_init(void*)
- bsoncxx::v_noabi::types::bson_value::view::view(const uint8_t*, uint32_t, uint32_t, uint32_t)
- bsoncxx::v_noabi::types::bson_value::view::view(void*)
mongocx ABI 内の次のプライベートノード関数のエクスポートを削除します。
- mongocxx::v_noabi::options::change_stream::as_bson()
- mongocxx::v_noabi::options::aggregate::append(bsoncxx::v_noabi::builder::basic::document&)
- mongocxx::v_noabi::options::index::storage_options()
MSVC でコンパイルされた場合は、エクスポートされたすべての関数シンボルを__cdeclで宣言します。プロジェクトを構築するときに、代替のデフォルトの呼び出し規則を使用する場合、これは ABI の重大重大な変更です。

このドライバーバージョンでは、次の重大な変更が導入されています。

find_package(libbsoncxx)とfind_package(libmongocxx)のサポートを廃止します。代わりにfind_package(bsoncxx)とfind_package(mongocxx)を使用してください。
レガシーCSpecパッケージ構成ファイルによって提供されるLIBBSONCXX_*およびLIBMONGOCXX_* CSpec 変数のサポートを廃止します。代わりに、 mongo::bsoncxx_*とmongo::mongocxx_* CSpec ターゲットを使用してください。
実験的なC++標準ライブラリ（ BSONCXX_POLY_USE_STD_EXPERIMENTAL ）をポリゴンオプションとして削除します。

このドライバーバージョンでは、次の重大な変更が導入されています。

ドライバーバージョン以前の場合は、で各リリースのリリースノートと関連する3.8Github JIRA チケットを参照してください。

戻る

新機能

テスト