$inc

運算子 $inc 會依指定的數量遞增域的值。 如果欄位不存在, $inc 請建立字段,並將它設定為指定的值。 運算符會分別接受正值和負值來遞增和遞減。

語法

運算子的 $inc 語法如下所示:

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

參數

參數 Description
field 要遞增的功能變數名稱。
amount 遞增值。 必須是數位(遞增為正數,遞減為負數)。

範例

請參考商店集合中的此範例檔。

{
  "_id": "40d6f4d7-50cd-4929-9a07-0a7a133c2e74",
  "name": "Proseware, Inc. | Home Entertainment Hub - East Linwoodbury",
  "staff": {
    "totalStaff": {
      "fullTime": 19,
      "partTime": 20
    }
  },
  "sales": {
    "totalSales": 151864,
    "salesByCategory": [
      {
        "categoryName": "Sound Bars",
        "totalSales": 2120
      },
      {
        "categoryName": "Home Theater Projectors",
        "totalSales": 45004
      }
    ]
  }
}

範例 1:遞增員工計數

若要將全職員工計數增加 3,請在 fullTime 員工欄位上使用值為 3 的$inc運算子。

db.stores.updateOne(
  { "_id": "40d6f4d7-50cd-4929-9a07-0a7a133c2e74" },
  {
    $inc: {
      "staff.totalStaff.fullTime": 3
    }
  }
)

範例 2:減少和增加值

若要將兼職員工減少 2 人,並將總銷售額增加 5000,請在兩個欄位上使用值分別為 -2 和 5000 的$inc運算子。

db.stores.updateOne(
  { "_id": "40d6f4d7-50cd-4929-9a07-0a7a133c2e74" },
  {
    $inc: {
      "staff.totalStaff.partTime": -2,
      "sales.totalSales": 5000
    }
  }
)

範例 3:建立新欄位

如果欄位不存在, $inc 請使用指定的值加以建立。

db.stores.updateOne(
  { "_id": "40d6f4d7-50cd-4929-9a07-0a7a133c2e74" },
  {
    $inc: {
      "staff.contractorCount": 5,
      "sales.monthlyTarget": 200000
    }
  }
)

範例 4:遞增陣列元素值

使用位置運算子更新 salesByCategory 陣列中的特定銷售數位。

db.stores.updateOne(
  { 
    "_id": "40d6f4d7-50cd-4929-9a07-0a7a133c2e74",
    "sales.salesByCategory.categoryName": "Sound Bars"
  },
  {
    $inc: {
      "sales.salesByCategory.$.totalSales": 500
    }
  }
)

完成這些操作後,文檔將更新如下:

{
  "_id": "40d6f4d7-50cd-4929-9a07-0a7a133c2e74",
  "name": "Proseware, Inc. | Home Entertainment Hub - East Linwoodbury",
  "staff": {
    "totalStaff": {
      "fullTime": 22,
      "partTime": 18
    },
    "contractorCount": 5
  },
  "sales": {
    "totalSales": 156864,
    "monthlyTarget": 200000,
    "salesByCategory": [
      {
        "categoryName": "Sound Bars",
        "totalSales": 2620
      },
      {
        "categoryName": "Home Theater Projectors",
        "totalSales": 45004
      }
    ]
  }
}