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サポートの詳細については、 サポート レガシー ポリシー を参照してください。