update コマンドは、コレクション内の既存のドキュメントを変更するために使用されます。
update コマンドを使用すると、フィルター条件に基づいて 1 つまたは複数のドキュメントを更新できます。 フィールドの値を変更したり、新しいフィールドと値を追加したり、既存のフィールドを削除したりできます。
例
StoreData データベースの stores コレクションのこのサンプル ドキュメントについて考えてみましょう。
{
"_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4",
"name": "First Up Consultants | Beverage Shop - Satterfieldmouth",
"location": {
"lat": -89.2384,
"lon": -46.4012
},
"staff": {
"totalStaff": {
"fullTime": 8,
"partTime": 20
}
},
"sales": {
"totalSales": 75670,
"salesByCategory": [
{
"categoryName": "Wine Accessories",
"totalSales": 34440
},
{
"categoryName": "Bitters",
"totalSales": 39496
},
{
"categoryName": "Rum",
"totalSales": 1734
}
]
},
"promotionEvents": [
{
"eventName": "Unbeatable Bargain Bash",
"promotionalDates": {
"startDate": {
"Year": 2024,
"Month": 6,
"Day": 23
},
"endDate": {
"Year": 2024,
"Month": 7,
"Day": 2
}
},
"discounts": [
{
"categoryName": "Whiskey",
"discountPercentage": 7
},
{
"categoryName": "Bitters",
"discountPercentage": 15
},
{
"categoryName": "Brandy",
"discountPercentage": 8
},
{
"categoryName": "Sports Drinks",
"discountPercentage": 22
},
{
"categoryName": "Vodka",
"discountPercentage": 19
}
]
},
{
"eventName": "Steal of a Deal Days",
"promotionalDates": {
"startDate": {
"Year": 2024,
"Month": 9,
"Day": 21
},
"endDate": {
"Year": 2024,
"Month": 9,
"Day": 29
}
},
"discounts": [
{
"categoryName": "Organic Wine",
"discountPercentage": 19
},
{
"categoryName": "White Wine",
"discountPercentage": 20
},
{
"categoryName": "Sparkling Wine",
"discountPercentage": 19
},
{
"categoryName": "Whiskey",
"discountPercentage": 17
},
{
"categoryName": "Vodka",
"discountPercentage": 23
}
]
}
]
}
例 1 - $inc演算子を使用して 1 つのドキュメントを更新する
totalSales を 10 ずつインクリメントし、指定した_idを使用してドキュメントのフルタイム スタッフの数を減らします。
db.stores.updateOne({"_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4"}, {"$inc": {"sales.salesByCategory.0.totalSales": 10, "staff.totalStaff.fullTime": -6}})
例 2 - $min演算子を使用して 1 つのドキュメントを更新する
フィールドの現在の値が 10 より大きい場合は、指定した_idを持つドキュメントの totalスタッフ数を 10 に更新します。
db.stores.updateOne({"_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4"}, {"$min": {"staff.totalStaff.fullTime": 10}})
例 3 - $max演算子を使用して 1 つのドキュメントを更新する
フィールドの現在の値が 14 未満の場合は、指定した_idを使用してドキュメントの total スタッフ数を 14 に更新します。
db.stores.updateOne({"_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4"}, {"$max": {"staff.totalStaff.fullTime": 14}})
例 4 - $mul演算子を使用して 1 つのドキュメントを更新する
指定した_id値を持つドキュメントのパートタイム従業員の数を 2 ずつ倍数にします。
db.stores.updateOne({"_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4"}, {"$mul": {"staff.totalStaff.partTime": 2}})
例 5 - $rename演算子を使用して 1 つのドキュメントを更新する
totalSales フィールドと total Staff フィールドの名前をそれぞれ fullSales と staffCounts に変更します。
db.stores.updateOne({"_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4"}, {"$rename": {"sales.totalSales": "sales.fullSales", "staff.totalStaff": "staff.staffCounts"}})
例 6 - $set演算子を使用して 1 つのドキュメントを更新する
指定した_id値を持つドキュメントの fullSales フィールドを 3700 に設定します。
db.stores.updateOne({"_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4"}, {"$set": {"sales.fullSales": 3700}})
例 7 - $unset 演算子を使用して 1 つのドキュメントを更新する
指定した_id値を使用して、ドキュメント内の場所オブジェクトから lon フィールドを削除します。
db.stores.updateOne({"_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4"}, {"$unset": {"location.lon": ""}})
例 8 - 複数のドキュメントを更新する
最初のプロモーション イベントが 2 月に始まるすべてのドキュメントを 3 月に開始するように更新します。
db.stores.updateMany({"promotionEvents.0.promotionalDates.startDate.Month": 2}, {"$inc": {"promotionEvents.0.promotionalDates.startDate.Month": 1}})
例 9 - 1 つのドキュメントをアップサートする
クエリ フィルターで指定されたドキュメントがコレクションに存在しない場合は、upsert フラグを true に設定して新しいドキュメントを作成します。
db.stores.updateOne({"_id": "NonExistentDocId"}, {"$set": {"name": "Lakeshore Retail", "sales.totalSales": 0}}, {"upsert": true})