AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu

スタンドアロンの 8.0 へのアップグレード

MongoDB 8.0 にアップグレードする前に、前提条件を含むこのドキュメントを検討してください。

MongoDB 8.0 では、 MongoDB 7.0 からのパフォーマンスの大幅な向上が導入されています。これには次のようなものがありますが、これらに限定されません。

  • 読み取りスループットが最大 36% 向上 します。

  • 一般的なウェブ アプリケーションのパフォーマンスが最大 32% 向上。

  • レプリケーション中の同時書込みを最大 20% まで高速化します。

注意

パフォーマンス向上の量は、ワークロードとデータベースインスタンスの構成によって異なる場合があります。

詳細については、 パフォーマンスの改善 を参照してください。

次の手順では、スタンドアロンのmongodをバージョン7.0から8.0にアップグレードする手順を概説します。

If you need guidance on upgrading to 8.0, MongoDB professional services offer major version upgrade support to help ensure a smooth transition without interruption to your MongoDB application.

アップグレードの際には、次の点を考慮してください。

既存の MongoDB デプロイを8.0にアップグレードするには、 7.0シリーズのリリースを実行している必要があります。

7.0シリーズより前のバージョンの場合、最終的に7.0シリーズになるまで、メジャー リリースを順次アップグレードする必要があります。 たとえば、6.0 シリーズを実行している場合、 にアップグレードする7.0 前に 、 まず にアップグレード8 する必要があります。0 。

Before you upgrade MongoDB, check that you're using a MongoDB 8.0-compatible driver. Consult the driver documentation for your specific driver to verify compatibility with MongoDB 8.0.

互換性のないドライバーでアップグレードを実行した場合、予期しないまたは未定義の動作が発生する可能性があります。

アップグレードを開始する前に、ドキュメント「 MongoDB 8.0での互換性の変更 」で、ご利用のアプリケーションとデプロイが MongoDB 8.0と互換性があることを確認してください。 アップグレードを開始する前に、お使いの環境の互換性の問題を解決してください。

MongoDB をアップグレードする際は、アップグレードを本番環境にデプロイする前に、必ずアプリケーションをステージング環境でテストします。

配置のバイナリ バージョンをダウングレードするには、サポートによる支援が必要です。

詳しくは、「 8.0から7.0へのダウングレード 」を参照してください。

7.0インスタンスでは、featureCompatibilityVersion が "7.0" に設定されている必要があります。featureCompatibilityVersion を確認するには、次のコマンドを実行します。

db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

この操作では、"featureCompatibilityVersion" : { "version" : "7.0" }を含むドキュメントが返されます。

featureCompatibilityVersion を設定または更新するには、次のコマンドを実行します。

db.adminCommand( { setFeatureCompatibilityVersion: "7.0", confirm: true } )

詳しくは、db.adminCommand() と setFeatureCompatibilityVersion を参照してください。

アップグレードする前に、スタンドアロン環境をレプリカセットに変換することを検討してください。レプリカセットは、MongoDB におすすめの配置構成です。

MongoDB8.0 にアップグレードする際に、時系列コレクションではないsystem.buckets コレクションがある場合は、drop renameに応じて、アップグレードする前にそれらのコレクションを または8 する必要があります。0 パッチ リリース:

MongoDB 8.0.5 以降

アップグレードする前に、時系列コレクションではない system.buckets コレクションを削除する必要はありません。ただし、アップグレードが完了した後に、これらを削除するか、名前を変更する必要があります。

MongoDB 8.0.4 以前

アップグレードする前に、時系列コレクションではない system.buckets コレクションを削除するか、名前を変更する必要があります。すべてのsystem.buckets コレクションは、 8.0.0-8.0.4 のバージョンにアップグレードする前に、有効な時系列オプションを構成する必要があります。

時系列コレクションではない system.buckets コレクションがあるかどうかを判断するには、フィルタを指定した db.getCollectionInfos() メソッドを使用します。

db.getCollectionInfos(
{
$and: [
{ name: { $regex: /^system\.buckets/ } },
{ 'options.timeseries': { $exists: false } }
]
}
)

MongoDB を MongoDB apt 、 yum 、 dnf 、またはzypperリポジトリからインストールした場合、パッケージ マネージャーを使用して8.0にアップグレードする必要があります。

Linuxシステムの場合は、8.0 のインストール手順を参照してください。新しいリリース用にリポジトリを追加して、実際にアップグレードする必要があります。

If you have not installed MongoDB using a package manager, you can manually download the MongoDB binaries from the MongoDB Download Center.

詳しくは、 8.0インストール手順を参照してください。

1

To shut down the mongod process, use mongosh to connect to the instance and run the following command:

db.adminCommand( { shutdown: 1 } )
2

8.0シリーズのバイナリがシステム パスにあることを確認します。 バイナリのバージョンを確認するには、次のコマンドを実行します。

mongod --version

コマンド出力は、 8.0シリーズのリリースを示しています。

3

この時点で、 7.0と互換性のない8.0機能を使わずに8.0バイナリを実行できます。

これらの 8.0 機能を有効にするには、機能の互換性バージョン(FCV)を 8.0 に設定します。7.0 以降にアップグレードする場合は、confirm を true に設定する必要があります。

Tip

下位互換性のないこうした機能を有効にすると、ダウングレード前に保持されていた下位互換性のない機能をすべて削除する必要があるため、ダウングレード プロセスが複雑になる場合があります。

ダウングレードの可能性を最小限に抑えるには、アップグレード後、バーンイン期間中にこれらの機能を有効にせずにデプロイを運用することをお勧めします。ダウングレードの可能性を最小限に抑えられたと確信できたら、これらの機能を有効にします。

以下のように、admin データベースに対して setFeatureCompatibilityVersion コマンドを実行します。

db.adminCommand(
{
setFeatureCompatibilityVersion: "8.0",
confirm: true
}
)

confirm の値を true に設定すると、操作を続行できます。confirm パラメータを省略するか、confirm に true 以外の値を設定すると、コマンドは失敗し、機能の互換性バージョン の変更に関する警告が返されます。警告には、クラスターの FCV をアップグレードまたはダウングレードした後は、バイナリ バージョンをダウングレードするには、サポートによる支援が必要であることが記載されています。

このコマンドは、内部システム コレクションへの書込みを実行する必要があります。何らかの理由でコマンドが正常に完了しない場合は、操作がべき等であるため、安全にコマンドを再試行できます。

mongod が終了した場合、 MongoDB はエラー コードを返します。アップグレードに関する問題をトラブルシューティングするには、エラー コード または 自己管理型配置の終了コードとステータス を参照してください。

If you experience startup issues after you upgrade, contact MongoDB Support for assistance.