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

Overview

このセクションでは、ドライバーを新しいバージョンにアップグレードするためにアプリケーションに加える必要がある変更を識別できます。

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

• 新しいドライバー バージョンが、アプリケーションが接続するMongoDB Server のバージョンと、アプリケーションが実行されるRuby のバージョンと互換性があることを確認します。互換性情報を表示するには、 互換性ページを参照してください。

• アプリケーションが使用しているドライバーの現在のバージョンとアップグレードが予定されているバージョンとの間の重大な変更については、「 重大な変更 」セクションを参照してください。

バージョン 2.18.0 以降、ドライバーは重大な変更を管理するために機能フラグ を使用します。この機能により、次のメジャー バージョン リリース前に重大な変更をオプトインすることができます。

バージョン管理

各Rubyドライバーのリリースには、MAJOR.MINOR.PATCH形式のバージョン番号があります。Rubyドライバーは セマンティック バージョン管理 (SemVer) を使用します。これは通常、次のことを意味します。

• 重大な変更、新機能の有効化、非推奨機能の削除は、メジャー バージョン リリースでのみ行われます。

• 新しい機能は 機能フラグ を使用して追加されます。このフラグは、オプトイン構成の変更によって有効にする必要があります。 これらの機能フラグは、メジャー リリースまたはマイナー リリースのいずれかで追加される可能性があります。

• 機能は、メジャー リリースまたはマイナー リリースで非推奨としてマークされる場合がありますが、少なくとも次のメジャー リリースまで機能は削除されません。

• パッチ バージョン リリースには、重大じゃない修正とセキュリティ更新のみが含まれます。

重大な変更

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

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