MongoDB 8.0 のリリースノート

8.0.1 - 10 月9 、 2024

修正された問題:

• SERVER-76883 外部ソースユーザーの「ロールが存在しません」ログのチャットボットを削減

• SERVER-82221 listCollections と listIndexes にはコミット保留中の名前空間が含まれます

• SERVER-94635 セッション更新パラメーターを構成可能にする

• SERVER- 挿入につながるアップサート95244 ステートメントが、クライアントがシャードに直接接続している場合、tassert によって失敗する可能性があります9146500

• WT-13409 __txn_checkpoint の 1 回の再試行は処理されない

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

• 8.0.1 変更履歴

8.0.0 - 10 月2 、 2024

このページの残りの部分では、 MongoDB 8.0で導入された変更点と新機能について説明します。

Database Profiler

データベースプロファイラーにフィルターを指定すると、新しいworkingMillisメトリクスに基づいて操作をログに記録できます。 workingMillisとdurationMillisの両方に基づいて操作をログに記録し、各メトリクスを異なるしきい値に設定できます。

BinData 変換

MongoDB 8.0以降では、 $convert演算子を使用して次の変換を実行できます。

• String values to binData values

• binData 値から string 値へ

MongoDB 8.0には新しいヘルパー式$toUUID } も含まれています。これは、string を UUID値に変換するための簡素化された構文を提供します。

$queryStats

MongoDB 7.1以降、 $queryStatsステージは記録されたクエリの統計を返します。

$rank と $denseRank の動作

MongoDB 8.0以降、 $denseRankおよび$rank sortBy操作のnullと欠落しているフィールド値は、ランキングを計算するときに同じように扱われます。 この変更により、 denseRankとrankの動作が$sortと一貫性が生じます。

Queryable Encryption 範囲クエリ

MongoDB 8.0以降、 Queryable Encryptionは、 $lt 、 $lte 、 $gt 、および$gte演算子を使用した、暗号化されたフィールドに対する範囲クエリをサポートしています。 詳細については、「 Queryable Encryption がサポートする操作 」を参照してください。 暗号化されたフィールドで範囲クエリを有効にするには、「暗号化スキーマの作成 」を参照してください。

ログ メッセージの OCSF スキーマ

MongoDB 8.0以降では、監査ログ メッセージにOCSFスキーマを指定できます。 OCSF スキーマは、 ログ プロセッサ と互換性のある標準化された形式でログを提供します。

ログ メッセージに使用されるスキーマを設定するには、 auditLog.schema構成ファイル オプションを使用します。

OCSF 形式のログ メッセージの例については、「 OCSF スキーマ監査メッセージ 」を参照してください。

Ingress キュー

MongoDB 8.0では、Ingress 認証制御用の新しいキューが導入されています。 ネットワークからデータベースへのエントリがあるのを待つ操作は、Ingress キューに入力されます。 デフォルトでは、キューは制限されていません。つまり、MongoDB ではすべての操作がこのステージでキューに入れられることなく実行できます。 キューの最大値を特定の値に設定すると、実行中の操作の数が指定された制限に達した場合、このステージで操作をキューに含めることができます。

コレクションの移動

MongoDB 8.0以降では、 moveCollectionコマンドを使用して、シャーディングされていないコレクションを別のシャードに移動できます。

詳細については、「移動可能なコレクション 」を参照してください。 開始するには、「コレクションの移動 」を参照してください。

コレクションのシャーディングの解除

MongoDB 8.0以降では、 unshardCollectionコマンドまたはsh.unshardCollection()メソッドを使用して、既存のシャーディングされたコレクションのシャーディングを解除できます。 この操作は、 コレクション内のすべてのドキュメントを、指定されたシャードまたはデータ量が最も少ないシャードに移動します。

詳細については、「シャーディングされていないコレクション 」を参照してください。 開始するには、「コレクションのシャーディングの解除 」を参照してください。

コンフィギュレーションシャード

MongoDB 8.0以降では、通常の シャーディングされたシャーディングされたクラスターのメタデータデータ に加えて、アプリケーションデータを保存するようにコンフィギュレーションコンフィギュレーションサーバーを構成できます。 コンフィギュレーションコンフィギュレーションサーバーとシャードサーバーの両方の機能を提供するmongodノードは、コンフィギュレーションシャードと呼ばれます。 シャードサーバー機能を持たないスタンドアロン--configsvrとして実行されるmongodノードは専用コンフィギュレーションサーバーと呼ばれコンフィギュレーションサーバー。

専用のコンフィギュレーションコンフィギュレーションサーバーをコンフィギュレーションシャードとして実行するように構成するには、 transitionFromDedicatedConfigServerコマンドを実行します。

コンフィギュレーションシャードを専用のコンフィギュレーションコンフィギュレーションサーバーとして実行するように構成するには、 transitionToDedicatedConfigServerコマンドを実行します。

詳細については、「コンフィギュレーションシャード」を参照してください。開始するには、「コンフィギュレーションシャードを使用してシャーディングされたシャードクラスタを開始する 」を参照してください。コンフィギュレーションシャードを使用してレプリカセットをシャーディングされたシャーディングされたクラスターに変換するには、「埋め込みコンフィギュレーションサーバーを使用してシャーディングされたシャードクラスタにレプリカセットを変換 」を参照してください。

新しいデータベースコマンド

• abortMoveCollection

• abortUnshardCollection

• moveCollection

• transitionFromDedicatedConfigServer

• transitionToDedicatedConfigServer

• unshardCollection

新しい mongosh メソッド

• sh.abortMoveCollection()

• sh.abortUnshardCollection()

• sh.moveCollection()

• sh.shardAndDistributeCollection()

• sh.unshardCollection()

serverStatus メトリクス

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

• shardingStatistics.countTransitionToDedicatedConfigServerStarted

• shardingStatistics.countTransitionToDedicatedConfigServerCompleted

• shardingStatistics.countTransitionFromDedicatedConfigServerCompleted

• shardingStatistics.configServerInShardCache

MongoDB 7.1には、チャンク移行に関する次の新しいシャーディング統計が含まれています。

• shardingStatistics.countDonorMoveChunkCommitted

• shardingStatistics.countDonorMoveChunkAborted

• shardingStatistics.totalDonorMoveChunkTimeMillis

• shardingStatistics.countBytesClonedOnRecipient

• shardingStatistics.countDocsClonedOnCatchUpOnRecipient

• shardingStatistics.countBytesClonedOnCatchUpOnRecipient

シャードあたりのデフォルトのチャンク

MongoDB 7.2 以降では、空のコレクションをハッシュされたシャードキーでシャードすると、 操作によってデフォルトでシャードごとに 1 つのチャンクが作成されます。 Previously, the operation created two chunks by default.

directShardOperations ロール

MongoDB 8.0以降では、 directShardOperationsロールを使用して、シャードに対してコマンドを直接実行する必要があるメンテナンス操作を実行できます。

シャーディングされたクラスターで有効になっているカーソルをすべて使用する

MongoDB7.1 以降、クライアントのmongos getMore リクエストで exhaustAllowed フラグが設定されている場合、 はエグゼキューションカーソルをサポートします。これにより、クライアントが 1 つのリクエストに対してデータベース サーバーから複数の応答を受け取った場合に、シャーディングされたクラスターでのクエリのパフォーマンスが向上します。

mongos ポート範囲

MongoDB 7.1以降、 mongosは [ 0 、 65535 ] から--port値を受け入れます。 詳しくは、 --portを参照してください。

部分的なシャードキーを含むクエリ

MongoDB 7.1以降では、 findAndModifyとdeleteOne()は部分的なシャードキーを使用してシャーディングされたコレクションをクエリできます。

再シャーディングの改善

MongoDB 7.2 では、コレクションの再シャーディング操作のパフォーマンスが大幅に向上し、操作の実行にかかる時間が大幅に短縮されます。

さらに、アプリケーションとクラスターが 必要な要件と制限を満たしている場合は、 reshardCollectionコマンドを使用して同じキーでコレクションを再シャーディングし、コレクションを再配布できます。これは、別の範囲移行手順 よりもはるかに高速です。

次のオプションが コマンドに追加されます。

例については、「新しいシャードへのデータの再配布 」を参照してください。

シャーディングされたクラスターの自己管理型バックアップ

MongoDB 7.1以降では、 fsync } コマンドとfsyncUnlockコマンドは、シャーディングされたクラスターで fsync 操作を実行できます。

lockフィールドをtrueに設定してmongosで実行すると、 fsyncコマンドはストレージ層からディスクに書き込みをフラッシュし、各シャードをロックして追加の書込みを防ぎます。 その後、 fsyncUnlockコマンドを使用してクラスターのロックを解除できます。

この機能により、 mongodumpを使用したシャーディングされたクラスターの自己管理型バックアップが可能になります。

シャーディングされたコレクションでの UpdateOne のアップサート動作

MongoDB7.1 以降、シャーディングされたコレクションで とともにupdateOne() upsert: true{ を使用する場合、フィルターに完全なシャードキーを含める必要はあり ません 。

シャーディングされたコレクションを使用したトランザクションの $lookup ステージ

MongoDB 8.0以降では、シャーディングされたコレクションをターゲットにしながら、トランザクション内で$lookupステージを使用できます。

過半数の書込み保証（write concern）

MongoDB 8.0以降、 "majority"書込み保証 ( 書込み保証 (write concern) ) を使用する書込み操作は、レプリカセットノードの過半数が変更のoplogエントリを書込んだときに確認応答を返します。 これにより、 "majority"書き込みのパフォーマンスが向上します。 以前のリリースでは、これらの操作はレプリカセットの過半数が変更を適用した後、待機して確認応答を返していました。

アプリケーションが{ w: "majority" }書込み (write)操作（因果整合性のあるセッションなし）からの確認応答を受信した後すぐにセカンダリから読み取る場合、クエリは書込み (write) からの変更を含まない結果を返すことがあります。

新しい replSetGetStatus メトリクス

MongoDB 8.0以降では、 replSetGetStatusコマンドを使用すると次のメトリクスが利用できます。

• replSetGetStatus.electionCandidateMetrics.lastSeenWrittenOpTimeAtElection

• replSetGetStatus.electionParticipantMetrics.lastWrittenOpTimeAtElection

• replSetGetStatus.electionParticipantMetrics.maxWrittenOpTimeInSet

• replSetGetStatus.members[n].optimeWritten

• replSetGetStatus.members[n].optimeWrittenDate

• replSetGetStatus.members[n].lastWrittenWallTime

• replSetGetStatus.optimeWritten

• replSetGetStatus.optimeWrittenDate

• replSetGetStatus.optimes.lastWrittenWallTime

• replSetGetStatus.optimes.writtenOpTime

oplogバッファ

MongoDB 8.0以降、セカンダリは各バッチの oplog エントリを並列に書込み、適用します。 書込みスレッドはプライマリから新しいエントリを読み取り、ローカル oplog に書込みます。 アプライアンス スレッドはこれらの変更をローカル データベースに非同期に適用します。 この変更により、セカンダリのレプリケーション スループットが向上します。

これにより、 metrics.repl.bufferに重大な変更が導入され、1 つのバッファではなく 2 つのバッファに対してメトリクスが提供されるようになりました。

MongoDB 8.0では、次のサーバー ステータス メトリクスが非推奨になります。

• metrics.repl.buffer.count

• metrics.repl.buffer.maxSizeBytes

• metrics.repl.buffer.sizeBytes

MongoDB 8.0は、次のサーバー ステータス メトリクスを追加します。

• metrics.repl.buffer.apply

• metrics.repl.buffer.apply.count

• metrics.repl.buffer.apply.maxCount

• metrics.repl.buffer.apply.maxSizeBytes

• metrics.repl.buffer.apply.sizeBytes

• metrics.repl.buffer.write

• metrics.repl.buffer.write.count

• metrics.repl.buffer.write.maxSizeBytes

• metrics.repl.buffer.write.sizeBytes

• metrics.repl.write

• metrics.repl.write.batchSize

• metrics.repl.write.batches

• metrics.repl.write.batches.num

• metrics.repl.write.batches.totalMillis

serverStatus メトリクス

MongoDB 8.0以降、次の新しいserverStatusメトリクスではtcmallocの使用に関する情報が報告されます。

• tcmalloc.usingPerCPUCaches

• tcmalloc.generic.peak_memory_usage

• tcmalloc.tcmalloc.cpu_free

• tcmalloc.tcmalloc.total_bytes_held

• tcmalloc.tcmalloc.cpuCache

• tcmalloc.tcmalloc.cpuCache.N.overflows

• tcmalloc.tcmalloc.cpuCache.N.underflows

• tcmalloc.tcmalloc_derived.total_free_bytes

シャットダウン パフォーマンス

MongoDB 8.0以降では、 Bulk.insert()およびデータ取り込みワークロードのパフォーマンスが向上する可能性があります。 ただし、これらのワークロードを実行した後すぐに MongoDB をシャットダウンすると、余計なデータがディスクにフラッシュされるため、時間がかかる可能性があります。

アプリケーション データをコンフィギュレーションシャードに保存

MongoDB 8.0以降では、通常のシャーディングされたクラスターのメタデータに加えて、アプリケーション データを保存するように コンフィギュレーションサーバー を構成できます。 また、コンフィギュレーションサーバーはコンフィギュレーションシャードと呼ばれます。 詳細については、「コンフィギュレーションシャード 」を参照してください。

圧縮の改善

MongoDB 7.3以降、 compactコマンドには、圧縮を続行するために回復可能な必要があるストレージ領域の最小量（メガバイト単位）が含まれる新しいfreeSpaceTargetMBオプションが含まれています。

同時 DDL 操作

MongoDB 7.1以降では、同じデータベースから異なるコレクションを対象とする複数のDDL 操作を実行する場合、MongoDB はそれらの操作を同時に実行します。

この変更により、 serverStatus locksフィールドとcurrentOp.locks出力に 2 つの新しいタイプが追加されます。

• DDLDatabase

• DDLCollection

mongos 集計クエリでのデータベース検証

MongoDB 7.2 以降、 mongos配置で存在しないデータベースを使用しようとする集計パイプライン クエリでは、検証エラーが返されます。

以前のバージョンでは、これらの集計クエリは空のカーソルを返していました。

DDL 操作

MongoDB 8.0では、クラスターが DDL 操作（ reshardCollectionなどのコレクションを変更する操作）を実行しているときにシャードを追加または削除すると、シャードを追加または削除する操作は、同時 DDL 操作が完了した後にのみ実行されます。

パイプラインのサイズ制限を超えるためのエラー コード

MongoDB 7.1以降では、パイプラインが パイプライン ステージの制限 を超えると、集計コマンドによってエラーがスローされるようになります。 詳細については、「ステージ数の制限 」を参照してください。

getField フィールドはすべての文字列をサポート

MongoDB 7.2 以降では、 演算子の 入力に、string に変換される任意の有効な 式field $getFieldを指定できます。以前のバージョンでは、field はstring定数のみを受け入れていました。

インデックス構築の改善

MongoDB 7.1 以降では、インデックス構築でのエラー報告が高速化され、障害回復力が高まります。 新しいindexBuildMinAvailableDiskSpaceMBパラメータを使用して、インデックスビルドに必要な最小ディスク容量を設定することもできます。これにより、ディスク容量が低すぎる場合はインデックスビルドが停止します。

次の新しいインデックス構築メトリクスが追加されました。

• indexBuilds.killedDueToInsufficientDiskSpace

• indexBuilds.failedDueToDataCorruption

詳細については、「インデックス ビルド 」を参照してください。

新しいパラメーター

新しい一括書込みコマンド

MongoDB 8.0以降では、新しいbulkWriteコマンドを使用して、1 回のリクエストで複数のコレクションに対して多くの挿入、アップデート、削除操作を実行できます。 既存のdb.collection.bulkWrite()メソッドでは、1 回のリクエストで 1 つのコレクションのみを変更できます。

新しいクエリシェイプとクエリ設定

MongoDB 8.0では新しいクエリシェイプが導入されています。 既存のクエリシェイプの名前が、プラン キャッシュ クエリシェイプに変更されます。

MongoDB 8.0以降では、新しいクエリシェイプのクエリ設定を追加できます。 クエリオプティマイザは、クエリプランニング中にクエリ設定を追加の入力として使用します。これは、一致するクエリシェイプを持つクエリを実行するために選択されたプランに影響します。

クエリ設定は、インデックス フィルターと比較して機能が向上しています。 インデックス フィルターも MongoDB 8.0以降は非推奨になっており、それらの使用は避けてください。

• クエリ設定を追加するには、 setQuerySettingsコマンドを使用します。

• クエリ設定を削除するには、 removeQuerySettingsコマンドを使用します。

• クエリ設定を取得するには、集計パイプラインの$querySettingsステージを使用します。

• クエリシェイプをブロックするには、「操作拒否フィルター 」を参照してください。

MongoDB 8.0以降では、次の出力にqueryShapeHashが含まれます。

• explain{ フィールドの コマンドexplain.queryShapeHash

• フィールドの データベースプロファイラsystem.profile.queryShapeHash

• フィールドの $currentOp 集計パイプライン $currentOp.queryShapeHashステージ

• 低速クエリ ログ

MongoDB 8.0以降、既存のqueryHashフィールドの名前がplanCacheShapeHashに変更されます。 以前のバージョンの MongoDB を使用している場合は、 planCacheShapeHashではなくqueryHashが表示されます。

Parameter Filtering

MongoDB 8.0以降、 getParameterコマンドはsetAtフィールドを受け入れます。 このフィールドを使用して、 allParameters: trueが返すドキュメントをフィルタリングして、スタートアップまたは実行時に設定できるパラメータのみを表示できます。

Cappedコレクションに関する 読み取り保証 (read concern)

MongoDB8.0 以降では、"snapshot" Capped コレクションで読み取り保証 を使用できます。

serverStatus 出力の変更

MongoDB 7.1以降では、 serverStatusコマンドの出力に次の新しいメトリクスが含まれています。

• changeStreamPreImages.expireAfterSeconds

• metrics.changeStreams.showExpandedEvents

• queryStats

MongoDB 7.2以降では、 serverStatusコマンドの出力に次の新しいメトリクスが含まれています。

• metrics.operation.killedDueToMaxTimeMSExpired

• readPreferenceCounters

MongoDB 7.3以降では、 serverStatusコマンドの出力に次の新しいメトリクスが含まれています。

• metrics.repl.stateTransition.totalOperationsRunning

• metrics.repl.stateTransition.totalOperationsKilled

• metrics.repl.waiters.replication

• metrics.repl.waiters.opTime

• planCache.classic.skipped

• planCache.sbe.skipped

MongoDB 8.0以降では、 serverStatusコマンドの出力に次の新しいメトリクスが含まれています。

• opWorkingTime

• opWorkingTime.commands

• opWorkingTime.reads

• opWorkingTime.writes

• opWorkingTime.transactions

updateOne のソート サポート

MongoDB 8.0以降、 updateOne()メソッドはsortオプションをサポートしています。 これは、MongoDB が更新を受信するドキュメントを選択する前にドキュメントを順序付けする方法を制御します。

以前のリリースでは、 findAndModify()メソッドとfindOneAndUpdate()メソッドを使用して、ユーザー指定のソート順序で最初のドキュメントを更新していました。 再試行可能な書込みをサポートするには、これらのメソッドがドキュメント全体を各ノードの特別なサイド コレクションにコピーする必要があります。これは、新しいsortオプションを備えたupdateOne()メソッドよりもコストのかかる操作です。

個別のコマンドのクエリ インデックス ヒントの指定

MongoDB 7.1以降では、 distinctコマンドでhintフィールドが使用でき、クエリのインデックスを指定できます。

TTL Indexes

MongoDB7.1 以降では、 Cappedコレクション に TTL インデックス を作成できます。

クエリ計画と実行

バッチ複数ドキュメント挿入操作

MongoDB 8.0以降、マルチドキュメントトランザクションの挿入操作では、個々のoplogエントリが生成されなくなりました。 代わりに、複数ドキュメントの挿入は 1 つのエントリとしてバッチ化されます。 各ドキュメントの変更ストリームinsertイベントには同じclusterTimeがあります。

この変更により、複数ドキュメント挿入操作のパフォーマンスが向上し、複数のoplog書込みによって発生する可能性のあるレプリケーションラグがなくなります。

OIDC IdP は発行者を共有できます

MongoDB 8.0以降では、複数の ID プロバイダー（IDP）が定義されている場合、 audience値が各発行者に対して一意である限り、 oidcIdentityProvidersパラメータは重複するissuer値を受け入れます。 これは、バージョン7.3および7でも利用できます。 0 。

サブパイプラインの名前空間

MongoDB 以降では、8.0 $lookupと$unionWith 内のサブパイプラインの名前空間が検証され、from collフィールドと フィールドが正しく使用されるようになりました。

詳細については、「 $lookup サブパイプライン 」と「 $unionWith サブパイプライン 」を参照してください。

クエリプランナーの最適化時間

explain()メソッドがクエリ プランナーの最適化時間に関する情報を返すようになりました。 queryPlanner.optimizationTimeMillisステータスは、クエリ プランナーが最適化に費やした時間をミリ秒単位で表示します。