HOWTO · MongoDB
在 MongoDB Shell 中刪除集合的所有記錄
在這篇 MongoDB 文章中,你將通過幾個示例瞭解如何使用 MongoDB 刪除集合中的記錄。我們將通過實現各種操作的示例來討論這一點。
本頁內容
若要清空 MongoDB 集合並保留集合本身,請在 mongosh 中執行 db.teams.deleteMany({}),並將 teams 換成你的集合名稱。空篩選器 {} 會符合所有文件,因此此命令會刪除該集合中的所有文件。若要連同集合及其索引一起刪除,請改用 db.teams.drop()。執行這兩種具破壞性的操作前,請先確認目前使用的資料庫和集合。
以下範例使用 teams 集合。MongoDB 的刪除方法會接收篩選文件:欄位條件會縮小符合條件的文件範圍,空篩選器則會符合所有文件。deleteOne() 最多刪除一份符合條件的文件;deleteMany() 則會刪除所有符合條件的文件。
選擇刪除文件或刪除集合
請根據操作後要保留的內容選擇方法:
- 使用
deleteOne(filter)刪除符合filter的至多一份文件。 - 使用
deleteMany(filter)刪除所有符合filter的文件。 - 使用
deleteMany({})刪除所有文件,但保留集合。 - 使用
db.teams.drop()刪除集合本身及其索引。
空篩選器會帶來重要影響:deleteOne({}) 會刪除一份符合條件的文件,但不保證會選到哪一份,也不保證是集合排序中的第一份。deleteMany({}) 則會符合所有文件。如果只想刪除部分記錄,就不應以此取代明確的篩選條件。
刪除一份符合條件的文件
傳入篩選條件給 deleteOne(),即可指定要比對的文件。例如,db.teams.deleteOne({ team: "Arsenal" }) 會刪除 team 欄位值等於 "Arsenal" 的至多一份文件。即使有多份文件符合條件,此方法仍只會刪除其中一份,不會刪除所有 Arsenal 記錄。若要刪除所有符合條件的文件,請使用 deleteMany()。
呼叫 db.teams.deleteOne({}) 同樣最多只會刪除一份文件,因為空篩選器會符合所有文件。MongoDB 不保證刪除的是集合排序中的第一份文件。若要清空集合,請改用 deleteMany({})。
刪除集合中的所有文件
如果要刪除所有符合條件的文件,請搭配條件使用 deleteMany()。例如,db.teams.deleteMany({ team: "Manchester" }) 會刪除所有 team 欄位值恰好等於 "Manchester" 的文件,其他隊伍的文件則會保留。比對依據是儲存的欄位值;如果刪除筆數少於預期,請檢查資料中的拼字和空格。
若要清空集合但保留集合,請執行 db.teams.deleteMany({})。由於 {} 不含欄位條件,因此所有文件都會符合。文件會被刪除,但集合仍可供日後新增文件使用。如果只想刪除特定記錄,請勿使用這種空篩選器形式。如果不再需要集合本身,請使用上文介紹的 drop 操作。
以下獨立的 JavaScript 範例以記憶體中的清單示範篩選刪除,模擬刪除所有 team 值為 Manchester 的文件。它不會連線到 MongoDB;請使用上方的 mongosh 命令操作你的資料庫。
本節程式碼及其顯示的標籤或輸出維持英文。
本節中的程式碼以及顯示的標籤或輸出仍為英文。
const teams = [
{ team: "Manchester", points: 70 },
{ team: "Liverpool", points: 69 },
{ team: "Manchester", points: 50 }
];
const filter = { team: "Manchester" };
const remaining = teams.filter(document => document.team !== filter.team);
console.log(remaining.map(document => document.team).join(", "));
輸出:
Liverpool
檢查刪除結果
MongoDB shell 的刪除方法會傳回結果文件,其中包含 deletedCount,也就是刪除的文件數量。例如,可以將結果指派給變數,再檢查筆數:const result = db.teams.deleteMany({ team: "Manchester" }); result.deletedCount。筆數為 0 表示沒有文件符合篩選條件;正數則表示刪除了相應數量的文件。對 deleteOne() 而言,筆數最多為 1。
使用 deleteMany({}) 清空集合後,結果中的 deletedCount 會顯示刪除的文件數量。如果數值為 0,集合可能原本就是空的,也可能是命令指向了非預期的資料庫或集合。重試前請確認目前使用的資料庫和集合名稱。這些檢查有助於分辨集合原本為空的正常結果與目標設定錯誤,且不必假設文件有特定順序。