重要
MongoDB 8.3 は最新のマイナー リリースです。MongoDB 8.2 以降では、特定のユースケースに合わせてオンプレミス配置(Community と EA)でマイナー リリースを利用できます。詳細については、 MongoDB のバージョン管理 を参照してください。
オンプレミスでサポートされている最新のMongoDBバージョンをインストールするには、インストール手順を参照してください。
このページでは、 MongoDB 8.3 で導入された、古いバージョンのMongoDBとの互換性に影響を与える可能性のある変更について説明します。
Indexes
より厳格なワイルドカード インデックスの検証
MongoDB8.3 (および8.2.4 、 、. 以降では、複合ワイルドカード8.0.18 7.029wildcardProjectionインデックスの: 仕様により厳格な検証ルールが適用されます。新しい検証要件を満たさない既存のインデックスは引き続き機能しますが、これらの要件を満たさない新しいインデックスを作成することはできません。
検証ルールの完全な詳細については、「 ワイルドカード インデックスの制限 」を参照してください。
一般的な変更点
$map、$filter、$reduce での配列要素インデックスへのアクセス
MongoDB 8.3 では、$map、$filter、$reduce 集計集計の配列要素インデックスへのアクセスが改善されます。新しい arrayIndexAsフィールドを使用して、配列要素のインデックスを保存するための変数を設定できます。また、arrayIndexAs を省略した場合は、新しい $$IDX集計システム変数を使用して現在の配列要素のインデックスにアクセスできます。
新しい配列要素インデックス機能を使用するビューまたはコレクション検証ルールを作成する場合は、 MongoDB8.3 から以前のバージョンにダウングレードする前に、ビューまたはルールをアップデートまたは削除する必要があります。
2dsphereIndexVersion
MongoDB8.3 以降、2 dsphereIndexVersion はデフォルトでバージョン4 に設定されています。
FCV を8.3 未満にダウングレードする必要がある場合は、まず2dsphere バージョン4 インデックスを削除する必要があります。
下位互換性のない機能
次のセクションでは、デプロイメントから下位互換性のない機能を削除するための情報を提供します。 MongoDB 8.3 から以前のバージョンにダウングレードする場合は、以下のセクションを確認して、ダウングレード後にデプロイが正常に実行されることを確認してください。
ビューにおける式
MongoDB 8.3 で導入された式を使用するビューを作成した場合、それらの式をサポートしていないバージョンにダウングレードすると、それらのビューが機能しなくなる可能性があります。
8.3 からダウングレードする必要がある場合は、まずターゲット バージョンでサポートされていない式に依存するビューを更新または削除する必要があります。
ビューとバリデーターのパラメーターと変数
MongoDB 8.3 で導入されたパラメータや変数を使用するビューやコレクション検証を作成した場合、ダウングレード後にそれらのオブジェクトは検証または評価に失敗する可能性があります。
8.3 からダウングレードする必要がある場合は、まずターゲット バージョンでサポートされていないパラメータや変数を参照ビューやバリデーターをアップデートまたは削除する必要があります。
検証済みコレクション
MongoDB 8.3 は、8.3 より前のバージョンと互換性のない新しい検証セマンティクスを使用して、コレクションを検証済みとしてマークできます。検証済みコレクションが存在しているときにダウングレードを試みると、ダウングレードは失敗します。
8.3 からダウングレードする必要がある場合は、まず検証済みコレクションをターゲット バージョンでサポートされている検証レベルに変更するか、それらのコレクションを削除する必要があります。
$ ファセットメモリ制限エラーコード
MongoDB8.3 以降、$facet ステージで100 メガバイトの制限を超えるドキュメントが構築されると、 MongoDB はExceededMemoryLimit エラーを返します。
以前のバージョンでは、メモリ制限を超えるステージはエラー コード4031700 を返します。 を明示的にチェックするアプリケーション、ドライバー、またはツールがある場合は、代わりに4031700 ExceededMemoryLimitを認識するようにコードを調整できます。
$convert パイプラインの非正規数
MongoDB8.3 以降、サーバーは表現可能なすべての倍精度浮動点数の全範囲を解析できます。これには、最上位桁の先頭にゼロがあり、指数の値が最小である非正規数が含まれます。 MongoDBの以前のバージョンでは、これらの数値を解析しようとすると、サーバーはエラーを返します。
詳細については、「 非正規数 」を参照してください。
バランサー ウィンドウ設定
MongoDB 8.3 から以前のバージョンにダウングレードする場合、activeBalancerWindowDOW 構成は使用できません。ダウングレードでは、バランサーはデフォルトで activeWindow 設定を使用します。
手動のダウングレード手順は必要ありませんが、8.3 で行われたカスタム曜日(DOW)構成はダウングレード後は適用されません。