運算子 $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
}
]
}
}