MongoDB 5.0 での互換性の変更

プラットフォーム サポート

一部のコマンドは、認識されたパラメーターのみを受け入れ

MongoDB 5.0 以降、特定のデータベースコマンドで明示的に受け入れられないパラメーターが渡されると、エラーが発生します。MongoDB 4.4 以前では、認識されないパラメーターは暗黙で無視されます。

影響を受けるコマンド:

• abortTransaction

• aggregate

• authenticate

• collMod

• commitTransaction

• create

• createIndexes

• delete

• drop

• dropDatabase

• dropIndexes

• endSessions

• explain

• find

• findAndModify

• getMore

• hello

• insert

• killCursors

• listCollections

• listDatabases

• listIndexes

• ping

• refreshSessions

• update

削除されたコマンド

MongoDB 5.0 以降では、次のデータベースコマンドとmongo shellヘルパー メソッドが排除されます。

削除されたパラメーター

MongoDB 5.0 では、次のサーバーパラメーターが除かれます。

削除されたインデックスの型

MongoDB 5.0では非推奨のgeoHaystackインデックスが削除されます。 代わりに2 d インデックスを使用してください。

MongoDB インスタンスを 5.0 にアップグレードし、featureCompatibilityVersion を 5.0 に設定すると、既存の geoHaystack インデックスがすべて削除されます。

削除されたメトリクス

MongoDB 5.0 以降、serverStatus コマンドは、クエリ操作で指定された読み取り保証 (read concern) レベルを含む、opReadConcernCounters を出力しません。代わりに、新しい readConcernCounters がopReadConcernCounters に置き換わり、追加情報が含まれます。

MongoDB 5.0 以降では、serverStatus コマンドは wiredTiger.snapshot-window-settings の下で cache pressure percentage threshold と current cache pressure percentage を出力しません。

削除された Raspberry Pi サポート

MongoDB 5.0 では Raspberry Pi のサポートが除かれます。Raspberry Pi で MongoDB を実行するには、バージョン 4.4 をインストールします。

に設定した場合の TTL の動作expireAfterSecondsNaN

MongoDB 5.0 以降では、expireAfterSeconds が NaN に設定された TTL インデックスの動作が以前のバージョンと比べて変更されます。

動作の変更は以下に影響します。

• 直接のアップグレード

• 以前のバージョンからの最初の同期

• mongorestore 以前のバージョンから

これらのアクションのいずれかを実行すると、NaN の expireAfterSeconds の値が 0 のexpireAfterSeconds として扱われます。その結果、ドキュメントはすぐに期限切れになる可能性があります。

MongoDB 5.0.14 (および 6.0.2) 以降では、サーバーは expireAfterSeconds が NaN に設定されている TTL インデックスを使用しません。

shell の変更

MongoDB v 5.0ではmongo shell は非推奨になりました。 置き換え shell はmongoshです。

MongoDB v 5.0 ではshellのパッケージも変更されています。詳細については、「インストール手順」を参照してください。

レプリカセット

if [ (#arbiters > 0) AND (#non-arbiters <= majority(#voting-nodes)) ]
    defaultWriteConcern = { w: 1 }
else
    defaultWriteConcern = { w: "majority" }

Capped コレクションの読み取り保証（read concern）snapshot

MongoDB 5.0 以降では、上限付きコレクションから読み取るときに読み取り保証 (read concern) "snapshot" を使用できません。

local は、デフォルトの読み取り保証 (read concern) で

MongoDB 5.0 以降では、プライマリとセカンダリに対する読み取り操作のデフォルトの読み取り保証 (read concern) レベルは "local" です。

これにより、フィルターを使用するカウントクエリと対象クエリのレイテンシが大幅に増加する可能性があります。

setDefaultRWConcern を使用してクラスター全体の読み取り保証 (read concern) を設定することで、この動作をオプトアウトできます。

新しいcursor.map() 戻り値の型

cursor.map()はレガシーのmongo shell でArrayを返しました。 戻り値の型は、 mongoshのCursorです。 .toArray()を使用して結果を変換できます。

演算子の変更のアップデート

MongoDB 5.0 以降では、空のオペランド式（{ }）で次のアップデート演算子を使用しても、mongod でエラーが発生しなくなりました。

• $addToSet

• $bit

• $currentDate

• $inc

• $max

• $min

• $mul

• $pop

• $pull

• $pullAll

• $push

• $rename

• $set

• $setOnInsert

• $unset

空にアップデートしても何も変更されず、oplog エントリも作成されません（つまり、操作は実行されません）。

$setWindowFields トランザクションとスナップショット読み取り保証 (read concern) があるステージ

MongoDB バージョン 5.3 より前では、$setWindowFields 集計パイプライン ステージはトランザクションまたは "snapshot" 読み取り保証 (read concern) では使用できません。

集計パイプライン演算子のパラメーター制限

次の集計パイプライン演算子には、64 ビットの整数値の最大制限が設けられました。

• $sort

• $limit

この制限を超える値を渡すと、パイプラインは無効な引数エラーを返します。

listDatabases 出力の変更

MongoDB 5.0 以降では、mongod に対して実行される listDatabases コマンドの出力は、mongos に対して実行される listDatabases の出力でもっと整合性が取れています。

次の表は、MongoDB 5.0 と以前のバージョン間の listDatabases 出力フィールドのデータ型の違いを示しています。5.0 と以前のバージョン間で異なるフィールドのみがリストされています。

mongos または mongod に対して実行された場合、listDatabases からの出力に totalSizeMb フィールドが含まれるようになりました。MongoDB 4.4 以前では、totalSizeMb は、mongos に対して実行された場合にのみ表示されます。totalSizeMb は、sizeOnDisk フィールドの合計で、メガバイト単位で表示されます。

mongos に対して実行すると、listDatabases 出力の shards フィールドに、特定のシャード上の各コレクションのフィールド値のペアが含まれます。shards フィールドのサイズ値は整数で表されます。

セキュリティ

Map-Reduce

MongoDB バージョン 5.0 以降、map-reduce 操作が廃止されました。

map-reduce 操作に代わる集計パイプラインの例については、「map-reduce から集計パイプラインへ」および「map-reduce の例」を参照してください。

監査

MongoDB 5.0 では、実行時に構成できる監査機能が追加されました。

auditLog.runtimeConfiguration が true に設定されている場合、mongod 構成ファイルおよび mongos 構成ファイルでは setParameter.auditAuthorizationSuccess の設定や監査フィルターの構成ができなくなります。サーバー構成ファイルにこれらの設定が含まれている場合、サーバーは起動に失敗し、エラーがログに記録されます。

auditLog.runtimeConfiguration が false に設定され、監査フィルター構成ドキュメントが存在する場合、スタートアップ警告は発行されますが、サーバーは中止されません。

シャーディングされたトランザクションにおける古いチャンクのリスク軽減

MongoDB 5.0 以降では、transactionLifetimeLimitSeconds パラメーターを変更する場合、すべてのコンフィギュレーションサーバーのレプリカセットのノードで transactionLifetimeLimitSeconds も同じ値に変更する必要があります。この値の一貫性を保つには、次の点に注意してください。

• ルーティング テーブルの履歴が、少なくともシャード レプリカセット ノードのトランザクション ライフタイム制限と同じ期間保持されるよう確認します。

• トランザクションの再試行頻度を減らし、パフォーマンスを向上させます。

一般的な変更点

MongoDB 5.0 以降:

• featureCompatibilityVersion が "5.0" 以上に設定されている場合、ユーザーは <database>.system.views コレクションに直接書き込むことができなくなります。

• reIndex コマンドと db.collection.reIndex() shell メソッドは、スタンドアロンインスタンスでのみ実行できます。

• 1 つのパイプラインで許可される集計パイプラインステージの数は 1000 に制限されています。

• directoryPerDB または --directoryperdb が有効な場合にデータベース内の最終コレクションを削除すると（またはデータベース自体を削除すると）、そのデータベースの新しく空になったサブディレクトリが削除されます。

• 結果の値を正確に表す必要がある場合、$subtract 集計演算子により、結果のデータ型を変換できます。具体的な変換方法については $subtractを参照してください。

• MongoDB では、--serviceExecutor コマンドライン オプションと対応する net.serviceExecutor 構成オプションが削除されます。

• --apiStrictオプションが設定されている場合は、同じクライアントのセッションで複数の同時ユーザーとして認証することはできません。 --apiStrictオプションが設定されている場合に、既存のユーザーとしてログインしているときに新規ユーザーとして認証しようとすると、認証の試行ごとにエラーメッセージが 1 回生成されます。 --apiStrictオプションを使用していない場合、既存のユーザーとしてログインしているときに新規ユーザーとして認証すると、認証の試行ごとに 1 回警告がログに書き込まれます。

• 重みオプションは、$text のインデックスに対してのみ許可されます。

• 暗黙的なデフォルトの書込み保証 (write concern) を変更する構成でシャーディングされていないレプリカセットを再構成する前に、グローバルでデフォルトの書込み保証 (write concern) を明示的に設定する必要があります。グローバルのデフォルトの書込み保証 (write concern) を設定するには、setDefaultRWConcern コマンドを使用します。

• mongoshでreplSetOplogサイズを設定するには、 Double()コンストラクターとreplSetResizeOplogコマンドを使用します。

• ワイルドカード インデックスは作成後に正規化されます。 インデックスを定義するwildcardProjectionドキュメントには、元のインデックス作成ステートメントとは異なる正規化された構文が含まれている場合があります。

• "*"をdropIndexesまたはdb.collection.dropIndexes()に渡すと、 _idインデックスと最後に残っているシャードキー インデックス（存在する場合）を 除くすべてのインデックスが削除されます。 最後に残っているシャードキー インデックスを明示的に削除しようとすると、エラーが発生します。

MongoDB 5.0.4以降 （および4.4.10 ）、 divisorまたはremainderの値が特定の値と評価された場合、 $mod演算子はエラーを返します。 $mod の動作 を参照してください。

5.0 機能の互換性

5.0 の一部の機能では、5.0 バイナリだけでなく、featureCompatibilityVersion（FCV）を 5.0 に設定する必要があります。これらの機能には、次のものが含まれます。

• 時系列コレクションを作成するには、FCV を 5.0 以上に設定する必要があります。

• ランタイム監査フィルターマネジメントを構成するには、FCV を 5.0 以上に設定する必要があります。

• フィールド名で . および $ を使用するには、FCV を 5.0 以上に設定する必要があります。

• コレクションを再シャーディングするには、FCV を 5.0 以上に設定する必要があります。

サーバー パラメータ

MongoDB 5.0.10以降、 coordinateCommitReturnImmediatelyAfterPersistingDecisionのデフォルト値はfalseです。