$push(数组更新)

适用对象: MongoDB vCore

$push 运算符用于将指定值附加到文档中的数组。 当需要向现有数组字段添加新元素而不影响数组中的其他元素时,此运算符非常有用。 它可用于各种方案,例如将新的销售类别、促销活动或员工成员添加到商店的文档。

语法

$push 运算符的基本语法如下所示:

db.collection.update(
   { <query> },
   { $push: { <field>: <value> } },
   { <options> }
)

参数

说明
<query> 要更新的文档的选择条件。
<field> 将附加值的数组字段。
<value> 要附加到数组字段的值。
<options> 可选。 更新操作的附加选项。

示例

让我们通过以下示例 json 来了解用法。

{
  "_id": "7954bd5c-9ac2-4c10-bb7a-2b79bd0963c5",
   "name": "Lakeshore Retail | DJ Equipment Stop - Port Cecile",
  "location": {
    "lat": 60.1441,
    "lon": -141.5012
  },
  "staff": {
    "totalStaff": {
      "fullTime": 2,
      "partTime": 0
    }
  },
  "sales": {
    "salesByCategory": [
      {
        "categoryName": "DJ Headphones",
        "totalSales": 35921
      }
    ],
    "fullSales": 3700
  },
  "promotionEvents": [
    {
      "eventName": "Bargain Blitz Days",
      "promotionalDates": {
        "startDate": {
          "Year": 2024,
          "Month": 3,
          "Day": 11
        },
        "endDate": {
          "Year": 2024,
          "Month": 2,
          "Day": 18
        }
      },
      "discounts": [
        {
          "categoryName": "DJ Turntables",
          "discountPercentage": 18
        },
        {
          "categoryName": "DJ Mixers",
          "discountPercentage": 15
        }
      ]
    }
  ],
  "tag": [
    "#ShopLocal",
    "#SeasonalSale",
    "#FreeShipping",
    "#MembershipDeals"
  ]
}

salesByCategory 数组添加新的销售类别“DJ 电缆”,总销售额为 1000.00。

db.stores.update(
   { _id: "7954bd5c-9ac2-4c10-bb7a-2b79bd0963c5" },
   { $push: { "sales.salesByCategory": { "categoryName": "DJ Cables", "totalSales": 1000.00 } } }
)

此查询将返回以下文档。

{
  "acknowledged": true,
  "insertedId": null,
  "matchedCount": "1",
  "modifiedCount": "1",
  "upsertedCount": 0
}