ドライバーのバージョンをアップグレードする
Overview
このページでは、 Cドライバーの新しいバージョンにアップグレードするときにアプリケーションに加える必要がある変更について説明します。
アップグレードする前に、次のアクションを実行してください。
新しいCドライバーのバージョンが、アプリケーションが接続するMongoDB Serverのバージョンと、アプリケーションを実行するプラットフォームと互換性があることを確認します。バージョンの互換性情報については、 Cドライバーの互換性 ページを参照してください。
アプリケーションが現在使用しているドライバー バージョンと計画されているアップグレード バージョン間の重大な変更については、 重大な変更 セクションを参照してください。 MongoDB Serverのリリース互換性の変更の詳細については、「 Server リリースの互換性の変更 」セクションを参照してください。
Tip
将来ドライバーのバージョンをアップグレードする際にアプリケーションに必要な変更の数を最小限に抑えるには、 Stable APIを使用します。詳しくは、「 Stable APIガイド」を参照してください。
重大な変更
注意
Cドライバーは セマンティック バージョン管理 に従います。 ドライバーは、どのリリースでもビルド システムまたはパッケージの互換性を中断する可能性があります。パッチ リリースにより、誤ってAPI重大な変更が元に戻る可能性があります。
重大な変更とは、ドライバーの特定のバージョン以降の規則または動作の変更です。 このタイプの変更では、ドライバーをアップグレードする前に対処しないと、アプリケーションが正常に動作しなくなる可能性があります。
このセクションの重大な変更は、それを導入したドライバーのバージョンによって分類されます。 ドライバーのバージョンをアップグレードするときは、現在のバージョンとアップグレードのバージョン間のすべての重大な変更に対処してください。
例
バージョン1.26からのアップグレード
Cドライバーをバージョン 1.26 からバージョン 1.27 にアップグレードする場合は、バージョン 1.27.0 から 1.27.6 にリストされているすべての重大な変更に対処します。
バージョン1.24.0 重大な変更
Cドライバーを構成するライブラリの 1 つである libmongoc の 1.24.0 リリースでは、次の下位互換性を重大な変更が導入されています。
Queryable Encryptionを使用するにはMongoDB Serverバージョン 7.0 以降が必要です。
サーバー リリースの互換性の変更
サーバー リリースの互換性の変更とは、MongoDB Server の一連のバージョンのサポートを廃止するドライバーに対する変更です。
ドライバーは、サポート終了（EOL）に達すると、MongoDB Server バージョンのサポートを終了します。
EOL 製品のMongoDBサポートの詳細については、 サポート レガシー ポリシー を参照してください。
バージョン 1.28.0 リリース サポートの変更
このドライバー バージョンは、 MongoDB Serverバージョン3.6 以前のサポートを削除します。バージョン1.28.0 以降の任意のドライバーを使用するには、 MongoDB Serverがバージョン4.0 以降である必要があります。このドライバー バージョンはMongoDB Server8.0 機能をサポートしています。 MongoDB Server配置をアップグレードする方法については、 MongoDB Serverマニュアルの リリースノート を参照してください。