适用对象: 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
}