$inc（更新演算子）

定義

次の環境でホストされる配置には $inc を使用できます。

$inc演算子の形式は次のとおりです。

{ $inc: { <field1>: <amount1>, <field2>: <amount2>, ... } }

<field> を埋め込みドキュメントまたは配列で指定するには、ドット表記を使用します。

MongoDB 5.0 以降、更新演算子では名前が文字列ベースのドキュメントフィールドを辞書順に処理します。数値名のフィールドは、数値順に処理されます。詳細については、「更新演算子の動作」を参照してください。

$inc演算子は正の値と負の値を受け入れます。

フィールドが存在しない場合、$inc はフィールドを作成し、そのフィールドを指定された値に設定します。

$incnull 値を持つフィールドで演算子を使用すると、エラーが発生します。

$inc は、1 つのドキュメント内のアトミック操作です。

MongoDB5.0 以降、mongod $incなどの更新演算子を空のオペランド式（）と併用しても、{ } でエラーが発生しなくなりました。空の更新を使用すると変更は一切されず、 oplogエントリも作成されません（操作は実行されません）。

products コレクションを次のように作成します。

db.products.insertOne(
   {
     _id: 1,
     sku: "abc123",
     quantity: 10,
     metrics: { orders: 2, ratings: 3.5 }
   }
)

次のupdateOne() 操作では、$inc 演算子を使用して次のようにします。

db.products.updateOne(
   { sku: "abc123" },
   { $inc: { quantity: -2, "metrics.orders": 1 } }
)

この操作では、次の結果を返します。

{
  _id: 1,
  sku: 'abc123',
  quantity: 8,
  metrics: { orders: 3, ratings: 3.5 }
}

Tip