HOWTO · MongoDB

更新 MongoDB 中的多個文件

在本文中,updateMany() 方法將用於一次更新多個文件。此方法更新與指定過濾器匹配的所有集合文件。

本頁內容

使用 MongoDB 的 updateMany() 方法,對所有符合篩選條件的文件套用同一項更新。本指南以 products 集合示範如何更新純量欄位、嵌入式文件和陣列位置,並說明如何判讀操作結果。

updateMany() 的運作方式

db.collection.updateMany() 方法會接受篩選條件、更新文件,以及一份選用的選項文件。它會將更新套用至篩選條件選出的所有文件。在本指南的範例中,這個方法不會變更文件的 _id;更新也可以新增原本不存在的欄位。

本指南範例中的更新文件會使用 $set 等更新運算子。這種以運算子為基礎的寫法不同於聚合管道更新;本指南不涵蓋管道更新。

理解篩選條件、更新內容與選項

第一個引數 filter 會使用與 find() 相同的查詢文件格式來選取文件。例如,{ price: 899 } 會選出 price 為 899 的文件;{} 則會符合集合中的所有文件,因此只有在確定要涵蓋整個集合時才使用空的篩選條件。

第二個引數 update 用來描述要進行的變更。更新文件會使用 $set 等運算子來修改欄位。選用的第三個引數可以包含 upsert;它的預設值是 false。若將 upsert 設為 true,而且沒有文件符合篩選條件,MongoDB 會根據篩選條件和更新內容插入一份文件。若有文件符合條件,則會更新這些文件。

使用 $set 可為欄位指定值;如果欄位不存在,也會建立該欄位。點記法可指定嵌入式文件中的欄位:$set: { "specs.ram": 32 } 會變更 specs 中的 ram,並保留該嵌入式文件的其他欄位。若直接設定 specs,則會以新值取代整個欄位。

以下小型 JavaScript 模型以一般物件示範相同的篩選與設定概念;它不會連線或呼叫 MongoDB:

本節中的程式碼以及顯示的標籤或輸出仍為英文。

const products = [
  { _id: 1, name: "xPhone", price: 799 },
  { _id: 2, name: "xTablet", price: 899 },
  { _id: 3, name: "SmartTablet", price: 899 }
];
const matched = products.filter(product => product.price === 899);
for (const product of matched) product.price = 895;
console.log(JSON.stringify(matched));

準備 products 集合

以下文件構成一致的範例資料集,供後續 MongoDB shell 操作使用。每份文件都包含價格、specs 嵌入式文件,以及 storage 陣列。

請在新的 products 集合中使用 db.products.insertMany([...]) 插入以下文件:

  • { _id: 1, name: "xPhone", price: 799, specs: { ram: 4, screen: 6.5, cpu: 2.66 }, storage: [64, 128, 256] }
  • { _id: 2, name: "xTablet", price: 899, specs: { ram: 16, screen: 9.5, cpu: 3.66 }, storage: [128, 256, 512] }
  • { _id: 3, name: "SmartTablet", price: 899, specs: { ram: 12, screen: 9.7, cpu: 3.66 }, storage: [16, 64, 128] }
  • { _id: 4, name: "SmartPad", price: 699, specs: { ram: 8, screen: 9.7, cpu: 1.66 }, storage: [128, 256, 1024] }
  • { _id: 5, name: "SmartPhone", price: 599, specs: { ram: 4, screen: 5.7, cpu: 1.66 }, storage: [128, 256] }

以下範例假設這些資料已存在,且每次操作都會根據集合目前的狀態執行。如果重複執行純量欄位更新,請重設範例資料,或調整篩選條件以符合資料目前的值。

更新符合條件的文件

若要將目前價格為 899 的所有產品改價,請呼叫 db.products.updateMany({ price: 899 }, { $set: { price: 895 } })。篩選條件會選出文件 2 和 3,而 $set 會將每份選中文件的 price 欄位設為 895。

你可以使用 db.products.find({ price: 895 }, { name: 1, price: 1 }) 確認變更後的值。投影會指定產品名稱和價格,讓查詢結果聚焦在此次更新涉及的欄位。使用這組範例資料時,查詢應會傳回兩項符合條件的產品。

更新嵌入式文件

使用點記法可以更新 specs 中的巢狀欄位,而不必取代整份嵌入式文件。例如,db.products.updateMany({ price: { $gt: 700 } }, { $set: { "specs.ram": 32, "specs.screen": 9.8, "specs.cpu": 5.66 } }) 會選出範例資料集中的產品 1、2 和 3,並在它們現有的 specs 文件中指定這三個值。

篩選條件使用範例資料中存在的 price 欄位,更新路徑則使用與嵌入式文件欄位名稱相符的 specs。請使用 db.products.find({ price: { $gt: 700 } }, { name: 1, price: 1, specs: 1 }) 查詢選出的產品,並檢查其 specs 值。

更新陣列元素

MongoDB 陣列索引從零開始。若要變更 _id 為 1、2 和 3 的產品之 storage 陣列中的前兩個位置,請使用 db.products.updateMany({ _id: { $in: [1, 2, 3] } }, { $set: { "storage.0": 16, "storage.1": 32 } })。點記法路徑會指定位置 0 和 1;後續元素會維持原值。

請使用 db.products.find({ _id: { $in: [1, 2, 3] } }, { name: 1, storage: 1 }) 檢查受影響的文件。此查詢會傳回這三項產品的名稱和陣列,方便你查看已變更的位置。

判讀更新結果與選項

updateMany() 會傳回一份結果文件。其中的 matchedCount 表示符合篩選條件的文件數量,modifiedCount 則表示實際變更的文件數量。如果符合條件的文件原本就有指定的值,這兩個數字可能不同。若 upsert 插入了文件,upsertedId 會標示插入文件的識別碼;若沒有插入文件,該欄位就不會提供新插入文件的識別碼。

請用這些數量確認操作範圍:將 matchedCount 與預期的篩選結果對照,再使用後續的 find() 查詢檢查已變更的欄位。結果文件說明這次更新操作的狀況;查詢則可用來確認資料庫中實際儲存的文件值。