定義
$min$minは、指定された値がフィールドの現在の値 より小さい 場合 、フィールドの値を指定された値にアップデートします。$min演算子は、 BSON 比較順序 を使用して、異なる型の値を比較できます。{ $min: { <field1>: <value1>, ... } } <field>を埋め込みドキュメントまたは配列で指定するには、ドット表記を使用します。
動作
MongoDB 5.0 以降、更新演算子では名前が文字列ベースのドキュメントフィールドを辞書順に処理します。数値名のフィールドは、数値順に処理されます。詳細については、「更新演算子の動作」を参照してください。
フィールドが存在しない場合、 $min演算子はフィールドを指定された値に設定します。
数値や null などの異なる型の値間の比較では、 $minはBSON 比較順序を使用します。
MongoDB 5.0 以降、$minなどの更新演算子を空のオペランド式({ })と併用しても、mongod でエラーが発生しなくなりました。空の更新を使用すると変更は一切されず、oplog エントリも作成されません(操作は実行されません)。
例
$minを使用して数値を比較
scores コレクションを次のように作成します。
db.scores.insertOne( { _id: 1, highScore: 800, lowScore: 200 } )
ドキュメントのlowScoreの値は現在200です。 次の操作では、 $minを使用して200と指定された値150を比較し、 150が200より小さいため、 lowScoreの値を150に更新します。
db.scores.updateOne( { _id: 1 }, { $min: { lowScore: 150 } } )
scoresコレクションには、次の変更されたドキュメントが含まれています。
{ _id: 1, highScore: 800, lowScore: 150 }
次の操作は、フィールドlowScoreの現在の値、つまり150が250より小さいため効果がありません。
db.scores.updateOne( { _id: 1 }, { $min: { lowScore: 250 } } )
scoresコレクションではドキュメントは変更されていません。
{ _id: 1, highScore: 800, lowScore: 150 }
$minを使用して日付を比較
tags コレクションを次のように作成します。
db.tags.insertOne( { _id: 1, desc: "crafts", dateEntered: ISODate("2013-10-01T05:00:00Z"), dateExpired: ISODate("2013-10-01T16:38:16Z") } )
次の操作では、 dateEnteredフィールドの現在の値、つまりISODate("2013-10-01T05:00:00Z")と指定された日付new Date("2013-09-25")とを比較して、フィールドを更新するかどうかを判断します。
db.tags.updateOne( { _id: 1 }, { $min: { dateEntered: new Date("2013-09-25") } } )
この操作によりdateEnteredフィールドが更新されます。
{ _id: 1, desc: "crafts", dateEntered: ISODate("2013-09-25T00:00:00Z"), dateExpired: ISODate("2013-10-01T16:38:16Z") }