このページでは、 MongoDB 8.2で導入された変更点と新機能について説明します。
MongoDB 8.2 はマイナー リリースであるため、 MongoDB Atlasとオンプレミスの配置の両方でサポートされています。MongoDB 8.2 は、メジャー バージョンのリリース サイクル内で段階的な改善を導入します。MongoDB 8.2 にはMongoDB 8.1 で導入された変更も含まれています。このページでは、マイナー リリースとMongoDB 8.2 で導入された変更について説明します。
メジャー リリースとマイナー リリースの違いの詳細については、MongoDB のバージョン管理 を参照してください。
重要
MongoDB 8.2 は最新のマイナー リリースです。MongoDB 8.2 以降では、特定のユースケースに対応したオンプレミス配置（MongoDB Community と Enterprise）でマイナー リリースを利用できます。詳細については、 MongoDB のバージョン管理 を参照してください。
オンプレミスでサポートされている最新のMongoDBバージョンをインストールするには、インストール手順を参照してください。
重要
mongosync はMongoDB 8.2 ではサポートされていません。
パッチ リリース
8.2.3 - Dec 19 、 2025
重要
MongoDB 8.2.3には、CVE-2025-14847に対する修正が含まれています。
MongoDBセキュリティ更新の最新情報については、MongoDBセキュリティ更新を参照してください。
修正された問題:
サーバー-115508: 非圧縮メッセージ用に最小サイズのバッファを作成します
8.2.2 - 11 月19 、 2025
修正された問題:
サーバー-103774: 複合ワイルドカードインデックスをシャードキーインデックスとして使用できない
サーバー-105047: シャーディングされたコレクションで
$orと$neを使用するクエリには、孤立したドキュメントが含まれる可能性がありますサーバー-110423:
$groupは sparse index で 個別のスキャン を使用できます。これにより、nullまたはmissing値を持つ結果は除外されますSERVER-110916:
targetShardsAndAddMergeCursors()で移動後に使用する問題を解決しましたサーバー-112467: 保留中のプロキシ接続数を追跡するおよび報告する
SERVER-112520: 既存の時系列バケットにドキュメントを挿入するときに、インデックスへの書き込みが失敗
8.2.1 - 10 月3 、 2025
修正された問題:
SERVER-94681: サンプリングをoplog上限維持スレッドに移動
サーバー-106469: 最新のビルドする版、ウィンドウで mongocryptd の起動が失敗する。
サーバー-108565: 時系列コレクションへの過大な書き込みの処理を改善します。
サーバー-109626: 変更ストリームで追加のフィールドを発行するための動作を調整しました
サーバー-110250: スピル WT 識別子を削除するときに既存のセッションを使用する
WT-15225: 新しく作成されたテーブルと削除() EBUSY の問題を修正
シャーディング
terminationSecondaryReadsOnOrganCreaup パラメーター
MongoDB8.2 terminateSecondaryReadsOnOrphanCleanupには、 チャンク移行に続く孤立したドキュメント の削除前に、セカンダリ ノードで長時間実行されている読み取り操作を自動的に終了するかどうかを制御する パラメーターが追加されています。
デフォルトでは 、このパラメータは true に設定されています。チャンク移行がコミットする前にセカンダリノードでの読み取り操作が開始された場合、 MongoDB は孤立したドキュメント を削除する前に、操作を自動的に終了します。8.2 より前のバージョンのMongoDBでは、孤立したドキュメントが削除された後もこれらの操作は実行され続け、エラーを返されることなくドキュメントが暗黙で欠落する可能性があります。
この新しい動作をサポートするために、orphanCleanupDelaySecs のデフォルト値は 3600（以前は 900）になりました。
一般的な変更点
最初の同期中のインデックス構築
MongoDB 8.2 以降、最初の同期中のインデックスビルドは、使用可能なRAMの 10% をデフォルトで 使用します。initialSyncIndexBuildMemoryPercentage パラメーターを使用して、 MongoDBが使用する別のパーセンテージを指定できます。
デフォルトでは 、使用可能なメモリの量は 200 MB から 16 GBまで（この値を含む）の範囲内である必要があります。メモリ使用量の異なる最小しきい値と最大しきい値を指定するには、次のパラメーターを使用します。
クエリ統計
MongoDB 8.2 以降では、$queryStats の出力には期限切れチケットに関する次のメトリクスが含まれます。
metrics.delinquentAcquisitionsmetrics.totalAcquisitionDelinquencyMillismetrics.maxAcquisitionDelinquencyMillis
MongoDB、取得に時間がかかりすぎる場合、実行チケットは期限切れと見なされます。
割合としてのWiredTigerキャッシュ サイズ構成
MongoDB 8.2 以降では、新しいパーセンテージベースのオプションを使用してWiredTiger内部キャッシュサイズを構成できます。既存の --wiredTigerCacheSizeGB と storage.wiredTiger.engineConfig.cacheSizeGB ギガバイトベースの設定に加えて、--wiredTigerCacheSizePct と storage.wiredTiger.engineConfig.cacheSizePct オプションを使用して、使用可能なメモリの割合としてキャッシュサイズを指定できるようになりました。
新しい不一致タイプ: 範囲削除のシャードキー インデックスの欠落
MongoDB8.2 以降では、新しい不整合タイプ が実装されています。不一致タイプは、コレクションシャードキーと互換性のあるインデックスを持たないシャーディングされたコレクションが存在し、完了する範囲削除タスクが少なくとも 1RangeDeletionMissingShardKeyIndex つあることを示します。
新しい集計式
MongoDB 8.2 以降では、$currentDate と aggregate() を併用すると、サーバーの現在時刻を返すことができます。
新しい $currentOp フィールド
$currentOp 集計ステージに versionContext フィールドが含まれるようになりました。このフィールドは、操作の 機能の互換性バージョン（FCV） に関する情報を提供します。
serverStatus 出力の変更
serverStatus には、出力に次の新しいフィールドが含まれます。
ディスク スピル ステージの Explain 出力
MongoDB 8.2 以降、ディスクにスピルするステージの説明結果に、一貫したフィールド名の下に標準化されたメトリクスが含まれるようになりました。このアップデートにより、メモリ集中型操作のディスク使用量をより統合的に追跡できます。
新しいフィールドには、次のものが含まれます。
検証出力の修復モード
MongoDB8.2 以降、validate コマンドとdb.collection.validate() ヘルパーメソッドは、 コマンドが修復を試みたデータ不整合が検出された場合に示す新しいrepairMode validateフィールドを返します。
zstd 高速圧縮のサポート
MongoDB 8.2 以降、storage.wiredTiger.engineConfig.zstdCompressionLevel 設定は、高速 zstd 圧縮の負の値をサポートしています。負の値を指定すると、圧縮比率がコスト、圧縮および解凍の速度が速くなります。新しいサポート範囲は -7 から 22 です。
ターゲットを絞ったミラーリングされた読み取り
MongoDB 8.2 以降では、読み取りミラーリングのノードをタグ付けすることで、キャッシュをウォームアップする必要がある特定のサーバーへ選択的に読み取り操作をミラーリングできます。一般的なミラーリングされた読み取りとは異なり、 ターゲットを絞った読み取りミラーリングでは 、非表示のノードをターゲットにして、プライマリとセカンダリ ノードの両方からミラーリングできます。
mirrorReads パラメータの targetedMirroringフィールドを使用して、対象を絞ったミラーリングされた読み取りを構成できます。
レート制限 Ingress 接続確立
MongoDB 8.2 以降では、Ingress 接続のレート制限を有効にして、過負荷時に CPU リソースを保持できます。有効にすると、着信接続のレートが指定された接続確立レートを超えるタイミングを確認でき、 MongoDBデプロイの超過接続の処理方法を指定するためのパラメーターを構成します。
次の新しいフィールドを使用してレート制限を構成できます。
セキュリティ
Queryable Encryption のプレフィックス、サフィックス、サブストリングのクエリのパブリック プレビュー
警告
プレフィックス、サフィックス、サブストリング クエリはパブリック プレビュー段階です。
Queryable Encryption のプレフィックス、サフィックス、サブストリング クエリは、 MongoDB 8.2 でpublic previewで利用できます。これらのクエリ タイプは本番環境では有効にしないでください。パブリック プレビュー機能は GA 機能と互換性がなくなるため、これらのクエリを有効にするコレクションはすべて削除する必要があります。
MongoDB 8.2 を使用すると、 Queryable Encryptionが有効なコレクション内の暗号化された文字列フィールドに対してプレフィックス、サフィックス、およびサブストリング クエリを有効にできます。 詳細については、部分文字列クエリの有効化とサポートされている集計式を参照してください。
mongosh でパブリック プレビューのプレフィックス、サフィックス、またはサブストリング クエリを使用するには、個別に自動暗号化共有ライブラリ 8.2 以降をダウンロードするし、--cryptSharedLibPath オプションを使用して mongosh へのライブラリ パスを指定する必要があります。
既知の問題点
このセクションでは、MongoDB 8.2の既知の問題とその解決ステータスについて説明します。
バージョン | 問題 | ステータス |
|---|---|---|
8.2.0 | SERVER-106469: You can avoid the .NET/C# Driver mongocryptd issue in the following ways:
| MongoDB 8.2.1 では、この問題の修正をターゲットにしています。 |
8.2.0 | SERVER-109626: v8.2.0は、変更ストリームのパフォーマンスの低下を導入します。リアルタイムデータ処理のために変更ストリームに依存するアプリケーションでは、 v8.0 と比較して最大 15% のパフォーマンスが低下する可能性があります。 | MongoDB 8.2.1 では、この問題の修正をターゲットにしています。 |
8.2.0 | SERVER-110250: ディスク書き込みを必要とするメモリ集中型の操作を実行中ユーザーは、アクティブにスピルしたクエリの数が | MongoDB 8.2.1 では、この問題の修正をターゲットにしています。 |
サーバー パラメータ
MongoDB 8.2 以降では、次のサーバーパラメータを使用できます。
MongoDB 8.1 に導入された変更
次のセクションでは、 MongoDB 8.1 に導入された変更点と新機能について説明します。
クエリ設定にコメントを追加する
MongoDB 8.1（および 8.0.4）以降では、setQuerySettings を使用してクエリ設定にコメントを追加できます。例、クエリ設定を追加した理由を示すコメントを追加します。
集計アキュムレータ
MongoDB 8.1 以降では、次の集計アキュムレータが利用できます。
集計ステージ
MongoDB 8.1 以降では、次の集計ステージが利用できます。
監査ログの改善
MongoDB 8.1 以降では、クライアントアプリケーションがロードバランサーを介して mongod または mongosインスタンスに接続する場合、元のクライアントコンピューターとロードバランサーのIPアドレスとポートが監査するログに含まれます。ログを使用して、監査するイベントと元のクライアントコンピューターを照合できます。
詳細については、OCSF スキーマ監査メッセージ および mongo スキーマ監査メッセージ を参照してください。
connectionStatus 接続UUID
MongoDB 8.1 以降では、connectionStatus.authInfo.UUID を介して現在接続されているクライアントの UUID にアクセスできます。
ディスクスペース
MongoDB 8.1（および 8.0.5）以降、ディスク容量が実行中場合、 MongoDB はディスクにスピルするクエリを失敗します。
$geoNear の改善点
MongoDB 8.1 以降、非表示の 2d または 2dsphere インデックスを持つ、以前は失敗した $geoNear クエリの一部が成功するようになりました。以前のリリースでは、使用するインデックスに関する混乱が原因で、非表示インデックスを含む場合に一部の $geoNear クエリは不必要に失敗し、IndexNotFound エラーが発生する問題が発生していました。
操作時間メトリクスの精度の向上
MongoDB 8.1 以降、低速クエリ ログで報告される durationMillis メトリクスは、認可処理と コマンドの解析に費やされた時間を考慮します。その結果、durationMillis はより完全なコマンド期間を反映します。
不一致のタイプ
MongoDB 8.1 以降では、次の不整合タイプが利用できます。
$lookup 暗号化されたコレクションのサポート
MongoDB 8.1 以降では、$lookup ステージで複数の暗号化されたコレクションを参照できます。
詳しくは以下を参照してください。
$merge 欠落フィールド
MongoDB 8.1 以降では、$merge集計ステージのサポートインデックスがスパースでない場合、オンオプションに指定されたフィールドが欠落しているか、null 値が含まれている可能性があります。
クエリ統計
MongoDB 8.1 以降では、count コマンドと distinct コマンドでクエリ統計が収集および報告されます。詳細については、count コマンド クエリ シェイプ と 個別の コマンド クエリ シェイプ を参照してください。
サーバー パラメータ
MongoDB 8.1 以降では、次のサーバーパラメータを使用できます。
serverStatus メトリクス
MongoDB8.1 （および8.0.4 7.0.14、6.0 、.20 ）以降、 コマンド出力のindexStats serverStatusセクションは、prepareUnique 状態のインデックスを追跡します。
MongoDB 8.1は、次のサーバー ステータス メトリクスを追加します。
maxTimestampEligibleForTruncateinchangeStreamPreImages.purgingJobmetrics.abortExpiredTransactions.successfulKills（8.0.13でも利用可能）metrics.abortExpiredTransactions.timedOutKills（8.0.13でも利用可能）
ディスクスピルに関する低速クエリ メトリクス
MongoDB 8.1 以降、クエリ実行で一時ファイルがディスクに書き込まれる場合、低速クエリのログメッセージに新しいメトリクスが含まれるようになりました。これらのメトリクスには、クエリがメモリ制限を超える原因となったクエリ実行ステージによってプレフィックスが付けられます。例、sortSpills は、クエリ実行のソート ステージが一時ファイルをディスクに書込んだ回数を示します。
メトリクス | 説明 |
|---|---|
| 対応するクエリ実行ステージが一時ファイルをディスクに書込んだ回数 |
| 一時ファイルをディスクに書き込むことで解放されるメモリのサイズ（バイト単位） |
| 一時ファイルに使用されるディスク領域のサイズ（バイト単位） |
| ディスク上の一時ファイルに書き込まれたレコードの数 |
ディスクへの一時ファイルの書き込みの詳細については、allowDiskUse() を参照してください。
Stable API
MongoDB 8.1 以降では、renameCollection コマンドと対応するシェルメソッドである db.collection.renameCollection() が Stable API V1 に含まれています。
explain の結果での検索ステージのサポート
MongoDB 8.1 以降では、explain 結果には $search、$searchMeta、および $vectorSearch ステージの実行統計が含まれます。
詳しくは以下を参照してください。
ビューに対する検索インデックスコマンドのサポート
MongoDB 以降では、8.1 createSearchIndexesupdateSearchIndex、 、dropSearchIndex 、$listSearchIndexes を実行して、Atlas Search インデックスと Atlas ベクトル検索インデックスを作成、変更、削除、一覧表示できます。これは互換性のある標準ビューでのみを含みます次のステージを使用します。
$search 検索インデックスを使用するビューでは、ステージと $searchMeta ステージを含む集計パイプラインを実行できます。また、ベクトル検索インデックスを含むビューで、$vectorSearch ステージを含む集計パイプラインを実行することもできます。
コマンドインデックスの仕様出力の検証
MongoDB 8.1 以降では、validate コマンドの validate.indexDetails 出力フィールドにインデックス指定が含まれます。
無効なドキュメントを処理するための検証アクション
MongoDB 8.1 以降では、スキーマの validationAction オプションを errorAndLog に設定できます。これにより、 MongoDB は検証条件に違反する挿入またはアップデートを拒否し、そのエラーを mongodログファイルに記録します。
詳細については、「無効なドキュメントの処理方法の選択」を参照してください。
アップグレード手順
重要
機能の互換性バージョン
MongoDB8.2 8.0配置から MongoDB にアップグレードするには、8.0 featureCompatibilityVersion配置で8.0 を に設定する必要があります。バージョンを確認するには、以下を参照してください。
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
MongoDB 8.2にアップグレードするには、MongoDB 配置に固有のアップグレード手順を参照してください。
8.2 へのアップグレードに関するガイダンスが必要な場合は、 MongoDBプロフェッショナル サービスがサポートを提供して、 MongoDBアプリケーションを中断することなくスムーズに移行できるようにします。詳細については、MongoDBコンサルティングを参照してください。
ダウンロード
MongoDB 8. 2 をダウンロードするには、MongoDB ダウンロードセンターにアクセスします。
ダウングレードの考慮事項
単一バージョンのダウングレードのみサポート
MongoDB は 1 つのバージョンのダウングレードのみをサポートします。現在のリリースより数バージョン前のリリースにダウングレードすることはできません。
例、8.2 シリーズの配置を 8.0 シリーズにダウングレードできます。ただし、8.0 シリーズの配置から 7.0 シリーズの配置へのさらなるダウングレードはサポートされていません。
ダウングレード ポリシー
MongoDB Community Edition ではバイナリー ダウングレードはサポートされていません。
デプロイの FCV をMongoDBのマイナー リリース バージョンにダウングレードしたり、マイナー リリース バージョンから任意のバージョンにダウングレードしたりすることはできません。
配置の FCv をアップグレードまたはダウングレードする場合、サポートの支援なしにエンタープライズ配置のバイナリ バージョンをダウングレードすることはできません。