MongoDB 8.3 のリリースノート

8.3.3 - 今後の予定

修正された問題:

• SERVER-115250 休止時間中に JWKSRefreshJob を一時停止する

• SERVER-121822 クラスター化されたコレクションでは、$lt 上の による結果のフィルタリングが正しく除外されません_id

• SERVER-125887 gRPC Egress の暗号化された PEM ファイルのサポートを追加

• SERVER-126049 MozJS のスコープごとのヒープ制限チェックでは、プロセスグローバル CC カウンターを使用

• WT-16780 のWT_PANIC チェックポイント失敗でエラーコンテキストが不十分__wt_block_checkpoint_resolve

• すべての Jira の課題は 8.3.3 で終了しました

• 8.3.3 変更履歴

8.3.2 - 5 月12 、 2026

修正された問題:

• SERVER-126021 時系列コレクションに重複するフィールド名を持つデータを挿入する際の未定義の動作

• すべての Jira の課題は 8.3.2 で終了しました

• 8.3.2 変更履歴

8.3.1 - 5 月4 、 2026

修正された問題:

• SERVER-121610 キャッシュされた emit() 呼び出しが正常に実行されないようにします

• サーバー-121895 検証エラーのリダクションを改善しました

• サーバー-124974 $match プッシュダウン分析中にメモリ有効期間を確保する

• すべての Jira の課題は 8.3.1 で終了しました

• 8.3.1 変更履歴

8.3.0 - 5 月4 、 2026

$map、$filter、$reduce での配列要素インデックスへのアクセス

MongoDB 8.3 では、$map、$filter、および$reduce 集計式の配列要素インデックスへのアクセスが改善されます。新しい arrayIndexAsフィールドを使用して、配列要素のインデックスを保存するための変数を設定できます。また、arrayIndexAs を省略した場合は、新しい $$IDX 集計システム変数を使用して現在の配列要素のインデックスにアクセスできます。

FTDC 統計

MongoDB 8.3 以降、フルタイム診断データ取得 （FTDC）は、 プロセスのconnPoolStats mongodメトリクスを収集します。

serverStatus 出力

serverStatus には、出力に次の新しいフィールドが含まれます。

• aggregate.withExtension metrics.commands.aggregate のサブフィールド、成功と失敗のカウントの追跡

• shardingStatistics.databaseCriticalSectionStatistics

• shardingStatistics.collectionCriticalSectionStatistics

• shardingStatistics.databaseVersionUpdateCounters

• metrics.ttl.deletedKeys

• metrics.ttl.durationMicros

• metrics.ttl.examinedDocuments

• metrics.ttl.examinedKeys

• metrics.extension

• metrics.extension.totalAggStageExecMicros

• metrics.extension.apiCallSuccesses

• metrics.extension.apiCallFailures

• metrics.extension.vectorSearch

• metrics.extension.vectorSearch.legacyVectorSearchUsed

• metrics.extension.vectorSearch.extensionVectorSearchUsed

• metrics.extension.vectorSearch.onViewKickbackRetries

• metrics.extension.vectorSearch.inSubpipelineKickbackRetries

• metrics.repl.network.oplogFetcherLagSeconds

• metrics.repl.network.oplogGetMoresProcessed

• queues.execution.admissions

• queues.execution.backgroundTasksDeprioritization

• queues.execution.deprioritizationGate

• queues.execution.heuristicDeprioritization

• queues.execution.heuristicDeprioritizationThreshold

• queues.execution.totalDeprioritizations

• queues.execution.usesPrioritization

• queues.execution.usesThroughputProbing

• queues.execution.nonDeprioritizable

• queues.execution.deprioritizable

• queues.execution.read.normalPriority.totalDelinquentAcquisitions

• queues.execution.read.normalPriority.totalAcquisitionDelinquencyMillis

• queues.execution.read.normalPriority.maxAcquisitionDelinquencyMillis

• queues.execution.read.lowPriority

MongoDB 8.3 で serverStatus 出力の serviceフィールドが削除されます。

MongoDB 8.3 以降では、none: 1 を指定することで、serverStatus の出力からすべての任意フィールドを除外できます。任意のフィールドをすべて除外した後、含めるフィールドを指定できます。

詳細については、すべての任意フィールドを除外する を参照してください。

オプションで、serverStatus コマンドで lockContentionMetrics: 1 を指定して、出力に lockContentionMetrics を含めることもできます。

string 変換の機能強化

Starting in MongoDB 8.3, $toString can convert additional BSON types to strings, including オブジェクト, 配列, regular expressions, MaxKeys, MinKeys, and timestamps.詳細については、$toString を参照してください。

MongoDB 8.3 では、$convert を使用して文字列と数値を変換するための任意の base 引数が導入されています。2、8、10、16 の基数を使用します。詳細については、$convert を参照してください。

配列変換の機能強化

MongoDB 8.3 以降では、$convert または 短縮式$toArray を使用して、配列を表す string を変換できます。

また、binData と数値の配列の間を変換することもできます。詳細については、binData を配列に変換する および 数値の配列を binData に変換する を参照してください。

オブジェクト変換の機能強化

MongoDB 8.3 以降では、$convert または短縮式 $toObject を使用して、オブジェクトを表す string を変換できます。

地理空間インデックスの生成

MongoDB 8.3 以降では、ドキュメントに GeoJSON とレガシー数値座標フィールドの両方が含まれている場合、地理空間インデックス生成は GeoJSON 座標を優先します。

ドキュメントに GeoJSON 座標に先行するレガシー数値座標値が含まれ、既存のインデックスがその動作に依存している場合は、地理空間インデックスを 再構築 する必要がある場合があります。

この変更により、documentに GeoJSON 座標に先行するレガシーの数値座標値が含まれており、既存のインデックスがその動作に依存している場合は、地理空間インデックスを再構築する必要がある場合があります。地理空間クエリを確認して、期待どおりの結果が返されることを確認します。

シャード変更の削除

MongoDB 8.3 以降、removeShard コマンドは非推奨です。このリリースでは、removeShard に代わる 4 つの新しいコマンドが導入され、シャードのドレインと削除プロセスを細かく制御できるようになります。

• startShardDraining

• stopShardDraining

• shardDrainingStatus

• commitShardRemoval

MongoDB には、埋め込みコンフィギュレーションサーバーから専用のコンフィギュレーションサーバーに移行するための 4 つの追加コマンドが用意されています。

• startTransitionToDedicatedConfigServer

• stopTransitionToDedicatedConfigServer

• getTransitionToDedicatedConfigServerStatus

• commitTransitionToDedicatedConfigServer

PreAuth 接続制限パラメーター

MongoDB 8.3 には、事前認証接続のリソース消費を制限する 3 つの新しいサーバーパラメータが追加されています。

• capMemoryConsumptionForPreAuthBuffers

• messageSizeErrorRateSec

• preAuthMaximumMessageSizeBytes

cachePressureQueryPeridMillseconds パラメーター

MongoDB 8.3 には、ストレージエンジンキャッシュ負荷のチェック間でMongoDB が待機する時間を設定する cachePressureQueryPeriodMilliseconds パラメーターが追加されています。ストレージエンジンがキャッシュ負荷に達している場合、 MongoDB は最も古いトランザクションを中止します。詳細については、cachePressureQueryPeriodMilliseconds を参照してください。

analyzeDataCollectionDirectorySizeMB パラメーター

MongoDB 8.3 は、diagnosticDataCollectionDirectorySizeMBのデフォルト値を 200 から 500 MiB に増加させます。

overloadAwareServerSelectionEnabled パラメーター

MongoDB 8.3 には、最近 SystemOverloadedError というラベルの付いたエラーを返したノードを回避するかどうかを制御する overloadAwareServerSelectionEnabled パラメーターが追加されています。このパラメーターを有効にすると、過負荷対応のリターゲティングをオプトインできます。

ingressRequestRateLimiterApplicationExemptions Parameter

MongoDB 8.3 以降では、ingressRequestRateLimiterApplicationExemptions パラメータを使用して、Ingressリクエストレート制限から除外するアプリケーションを指定できます。詳細については、ingressRequestRateLimiterApplicationExemptions を参照してください。

データベースプロファイラーのパラメータとメトリクス

MongoDB 8.3 には、データベースプロファイラーがクエリ パフォーマンスに与える影響を制御する 2 つのパラメーターが追加されています。

• internalQueryGlobalProfilingLockDeadlineMs

• internalProfilingMaxAbandonedWritesPerSecondPerDb

MongoDB 8.3 は、関連する 2 つの serverStatus メトリクスも追加します。

• profiler.totalAbandonedWrites

• profiler.dbsPastThreshold

再試行パラメータ

MongoDB 8.3 は、過負荷により失敗した操作を再試行するときに、内部サーバー側クライアント（mongos と mongod の間）のバックオフ方法を構成するパラメーターを追加します。

• defaultClientBaseBackoffMillis

• defaultClientMaxBackoffMillis

• defaultClientRetryAttempts

• shardRetryTokenBucketCapacity

• shardRetryTokenReturnRate

アップサート エラーのための BSONObjectTooLarge コード

8.3 以降、大きすぎるBSONオブジェクトを生成するアップサート操作では、10334 BSONObjectTooLarge エラー コードが返されます。以前のバージョンでは、大きすぎるBSONオブジェクトを生成するアップサート操作では 17419 または 17420 エラー コードが返されました。

コマンドの更新を検証する

8.3 以降、MongoDB は、full が true の場合、db.collection.validate() メソッドの checkBSONConformanceフィールドを自動的に有効にしなくなりました。さらに、db.collection.validate() メソッドは、コレクションに16 MB を超える document がないことを確認するようになりました。

新しい式 $subtype

MongoDB 8.3 では、binary データ オブジェクトのサブタイプを抽出するための新しい $subtype 式が導入されています。

拡張JSON変換の新しい式

MongoDB 8.3 では、 BSONと拡張JSON （EJSON）形式を変換するための新しい集計式が導入されています。

• $serializeEJSON - 型のラッパーを使用して、 BSON値を拡張JSON形式に変換します。標準と緩和型拡張JSON形式の両方をサポートします。

• $deserializeEJSON - 拡張JSON形式をネイティブBSON値に変換します。

これらの式を $convert と組み合わせると、 JSON string が解析され、拡張JSON値がネイティブBSON値に変換され、 JSON形式に変換されます。

新しい式 $createObjectId

MongoDB 8.3 以降では、$createObjectIdを使用してパイプラインと式ベースの更新で新しいランダムなObjectId()値を生成できます。

新しいハッシュ式

MongoDB 8.3 では、UTF-8 string または binary データからハッシュを生成するための 2 つの新しい集計式が導入されています。

• $hash - MD5、SHA-256、XXH64 を使用して UTF-8 string または binary データから BinData ハッシュ値を生成します。

• $hexHash - MD5、SHA-256、XXH64 を使用して、UTF-8 string または binary データから大文字の 16進数文字列ハッシュを生成します。

New $meta Keyword

MongoDB では、8.3 式に新しい"searchRootDocumentId" $metaキーワードが導入されています。この キーワードを使用すると、 結果セット内の埋め込みドキュメントのルートドキュメントの_id $search値を返すことができます。詳しくは、「 searchRootDocumentId 」を参照してください。

前のUNIXエポック日付

MongoDB 8.3 以降では、$dateAdd または $dateSubtract で unit が "millisecond" ではなく、input日付が ISODate("1970-01-01T00:00:00Z") より前の場合、結果は以前のバージョンのMongoDBより 1 秒大きくなります。これは、$setWindowFields や $densify のような時間ベースの計算を実行する集計の結果にも影響します。

地理空間インデックスの生成

MongoDB 8.3 は、 MongoDB 8.2 で導入された動作を継承します。If a document contains both GeoJSON とレガシー数値座標フィールドの両方が含まれている場合、地理空間インデックス生成では GeoJSON 座標が優先されます。

ドキュメントに GeoJSON 座標に先行するレガシー数値座標値が含まれ、既存のインデックスがその動作に依存している場合は、地理空間インデックスを 再構築 する必要がある場合があります。

この変更により、ドキュメントに GeoJSON 座標に先行するレガシーの数値座標値が含まれており、既存のインデックスがその動作に依存している場合は、地理空間インデックスを再構築する必要がある場合があります。地理空間クエリを確認して、期待どおりの結果が返されることを確認します。

$convert パイプラインの非正規数

MongoDB 8.3 以降、サーバーは表現可能なすべての倍精度浮動点数の全範囲を解析できます。これには、最上位桁の先頭にゼロがあり、指数の値が最小である非正規数が含まれます。

詳細については、「 非正規数 」を参照してください。

$trim、$ltrim、$rtrim の文字の長さ制限

MongoDB 8.3 以降、chars に提供する文字列の長さは 4096 文字に制限されています。詳細については、$trim 制限 を参照してください。

ウィンドウ関数

MongoDB 8.3 以降では、$mergeObjects を使用できます $setWindowFields 操作で。

SP.process() の制限オプション

MongoDB 8.3 以降、sp.process() は options.limit 入力パラメータをサポートしています。sp.process()が limit documentをターミナルに返すと、セッションは終了します。

クエリ エンジンでのテキスト検索スピル

MongoDB 8.3 以降では、クエリエンジンはTextOr ステージのメモリ使用量を 100 メガバイトに制限します。TextOr ステージは、テキスト スコアメタデータを読み取る $text クエリを処理します。例、TextOr は、結果をテキスト スコアでソートするクエリを処理します。TextOr ステージがこの制限を超えると、

• allowDiskUse が true の場合、ステージは中間結果をディスクに流出させます。

• allowDiskUse が false の場合、クエリはメモリ制限を超えるエラーで失敗します。

以前のバージョンでは、TextOr ステージはメモリ制限がなく、制限なくRAMを消費するため、メモリ不足（OOM）エラーが発生していました。

$trim、$ltrim、$rtrim の文字の長さ制限

MongoDB 8.3 以降、chars に提供する文字列の長さは 4096 文字に制限されています。詳細については、$trim 制限 を参照してください。

シャーディングされたクラスターの DDL 操作は mongos でのみ実行できます

MongoDB 8.3 以降では、すべてのシャーディングされたクラスターの mongos で DDL 操作 と applyOps のみを実行できます。レプリカセットからシャーディングされたクラスターに移行している間は、これらの操作が一時的に利用できなくなることがあります。

findShardsOnConfigTimeoutMS Parameter

MongoDB 8.3 には、config.shards名前空間に対する find 操作のタイムアウトをミリ秒単位で設定する findShardsOnConfigTimeoutMS パラメーターが追加されています。詳細については、findShardsOnConfigTimeoutMS を参照してください。

config.csrs.インデックス 削除

MongoDB 8.3 で config.csrs.indexes名前空間が削除されます。

2dsphereIndexVersion

MongoDB 8.3 以降、2dsphereIndexVersion はデフォルトでバージョン 4 に設定されています。

機能の互換性バージョン を 8.3 未満にダウングレードする必要がある場合は、まず 2dsphere バージョン 4 インデックスを削除する必要があります。

mongos ベースのクエリのシャードクエリ統計

MongoDB 8.3 以降、シャードサーバーでは、queryStats が有効になっている場合、クエリ統計に mongos から発生したクエリが含まれます。以前は、mongos からシャードに転送されたクエリのほとんどがシャードレベルのクエリ統計に表示されず、シャードレベル診断の完全性が低下していました。

シャーディングされたクラスターへの変換

MongoDB 8.3 以降では、以前にシャーディングされたクラスターであったレプリカセットをレプリカセットに変換することはできません。

シャーディングされたクラスターをレプリカセットに変換すると、 シャード ID documentなど、以前の配置のシャーディングメタデータが保持され、再度シャーディングされたクラスターになるのがブロックされます。自己管理型変換をシャーディングされたクラスターに戻しようとすると、 MongoDB はエラーを返します。

このようなレプリカセットをシャーディングされたクラスターに変換するには、テクニカル サポート にお問い合わせください。

埋め込みコンフィギュレーションシャードへの変換

MongoDB 8.3 では mongod --replicaSetConfigShardMaintenanceMode オプションが導入されています。

以前のリリースでは、レプリカセットを埋め込まれたコンフィギュレーションシャードを持つシャーディングされたクラスターに変換するには、まず専用のコンフィギュレーションサーバーレプリカセットを持つシャーディングされたクラスターに移行する必要がありました。

--replicaSetConfigShardMaintenanceMode と --configsvr オプションを使用してレプリカセットを再起動すると、プライマリノードを直接埋め込みコンフィギュレーションシャードに変換できます。

詳細については、「レプリカセットを埋め込みコンフィギュレーションシャードに変換する」を参照してください。

refineCollectionShardKey の形式設定

MongoDB 8.3 以降、時系列コレクション用の refineCollectionShardKey は、コレクションの論理メタと時間フィールドを使用して指定されたシャードキーのみを受け入れます。MongoDB、基礎となるバケット形式を使用したキーの指定はサポートされなくなりました。

インデックスの命名制限

MongoDB 8.3 以降では、"_id_" という名前のインデックスを作成するか、時系列コレクションで "_id_" のヒントを指定すると、エラーが返されます。

timeField の命名制限

MongoDB 8.3 以降では、$ 文字で始まる timeField を作成できません。

クエリでメモリの使用状況を追跡するフィールド

MongoDB 8.3 以降では、次の新しいフィールドを使用してクエリメモリの使用状況を追跡できます。

どちらのフィールドも次の場所に表示されます。

• $currentOp（集計ステージ）の出力

• db.currentOp() 出力

• Database profiler output

• ログ メッセージ

• 低速クエリログメッセージ

peakTrackedMemBytesフィールドは次の場所にも表示されます。

• explain の結果

• PlanCache.list() 出力

• $planCacheStats 出力

8.3 以降、$queryStats の次の新しいメトリクスを使用して、checkForInterrupt の動作を測定します。

• metrics.numInterruptChecksPerSec

• metrics.overdueInterruptApproxMaxMillis

Mongos クエリシェイプ フィールド

MongoDB 8.3 以降では、低速クエリのログエントリには、mongos に関連する次の操作のそのクエリシェイプを含む任意の originalQueryShapeHash フィールドがあります。

• find

• aggregate

• count

• distinct

進行中の低速クエリ ログ

MongoDB 8.3 では、低速進行中のクエリログエントリが導入されます。進行中の低速クエリのログ メッセージに含まれる情報は、標準の低速クエリ ログよりも少なくなります。MongoDB は、クエリの期間が slowOpInProgressThreshold を超えると、最大 1 回クエリをログに記録します。db.setProfilingLevel() または新しい mongod --defaultSlowInProgMS コマンドラインオプションを使用してしきい値を設定できます。

シャーディングされたクラスター

MongoDB 8.3 以降では、シャーディングされたクラスターに存在しないデータベースに対して explain() を実行すると、実行ステージはストリームの終端に達し、その操作ではデータベースは作成されません。ストリームの終端の実行統計の詳細については、explain.executionStats.executionStages.isEOF を参照してください。

SCRAM-SHA-1 および FIPS モード

Starting in MongoDB8.3 以降では、SCRAM-SHA-1 またはauthenticationMechanisms mongod --tlsFIPSModeも指定しながら、 にmongos --tlsFIPSMode を指定することはできません。

--tlsFIPSMode も指定しているときに authenticationMechanisms に SCRAM-SHA-1 を指定しようとすると、サーバーはエラーをスローし、次のようなメッセージをログに記録します。

SCRAM-SHA-1 is not allowed in FIPS mode.

単一バージョンのダウングレードのみサポート

MongoDB は、連番での単一バージョンのダウングレードのみをサポートします。現在のリリースより数バージョン前のリリースにダウングレードすることはできません。

• メジャーでもマイナーでも、どのバージョンでも、隣接するバージョンにアップグレードまたはダウングレードできます。例、8.3 から 8.2 にダウングレードしたり、7.0 から 8.0 にアップグレードしたりできます。

• メジャーでもマイナーでも、すべてのバージョンで、前のメジャー バージョンにダウングレードできます。例は、8.3 から 8.0 までです。

• どのマイナー バージョンでも、すぐに次のバージョンにアップグレードできます。例は、8.2 から 8.3 までです。

下位互換性のない機能

MongoDB 8.3 には、以前のリリースと互換性のない機能が含まれています。8.3 から以前のリリースにダウングレードするには、これらの機能を使用するデータを削除する必要があります。

詳しくは、「下位互換性のない機能」を参照してください。