Overview
このページでは、 C++ドライバーの新しいバージョンにアップグレードするときにアプリケーションに加える必要がある変更について説明します。
アップグレードする前に、次のアクションを実行してください。
Ensure the new C++ driver version is compatible with the MongoDB Server versions your application connects to and the C++ standard version your application compiles with. For version compatibility information, see Compatibility.
アプリケーションが使用しているドライバー バージョンとアップグレード予定のバージョンとの間の重大な変更については、 重大な変更 セクションを参照してください。
Tip
ドライバーのバージョンをアップグレードするときにMongoDB Serverのバージョン間で互換性を確保するには、 Stable APIを使用します。
重大な変更
注意
The C++ driver follows semantic versioning. The driver may break build system or package compatibility in any release. Patch releases may revert accidental API breaking changes.
重大な変更とは、ドライバーの特定のバージョン以降の規則または動作の変更です。 このタイプの変更では、ドライバーをアップグレードする前に対処しないと、アプリケーションが正常に動作しなくなる可能性があります。
このセクションの重大な変更は、それを導入したドライバーのバージョンによって分類されます。 ドライバーのバージョンをアップグレードするときは、現在のバージョンとアップグレードのバージョン間のすべての重大な変更に対処してください。
例
バージョン3.0からのアップグレード
C++ドライバーをバージョン3.0からバージョン3.10にアップグレードする場合は、バージョン3.1から3.10にリストされているすべての重大な変更に対処します。
バージョン3.11 重大な変更
MongoDB Server v 3.6のサポートを廃止します。
MongoDB Cドライバー v 1.28.0以降が必要です。
ENABLE_TESTS構成オプションがONに設定されている場合は、 C++14 以降が必要です。 CMax の構成中にENABLE_TESTS=OFFを使用したテストを無効にすることで、 C++14 要件をオプトアウトできます。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 の重大重大な変更です。
バージョン3.10 重大な変更
このドライバー バージョンでは、次の重大な変更が導入されています。
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.9 重大な変更
このドライバー バージョンでは、次の重大な変更が導入されています。
CSpecプロジェクト構築ツリーからエクスポートされたターゲットのサポートを削除します
macOS 10.14 、 macOS 10.15 、 Ubuntu 14.04のサポートを廃止します。
MongoDB Cドライバー v 1.25.0以降が必要
CSpec v 3.15以降が必要
バージョン3.8以前
For driver versions 3.8 and earlier, see the release notes and associated JIRA tickets for each release on GitHub.