如何在 MongoDB 中管理文件

使用 insert() 方法

insert() 方法允許您將一個或多個文件插入到呼叫它的集合中。

若要插入單個文件，請透過在集合上呼叫該方法將文件傳遞給該方法。在這裡，我們為名為 Ashley 的學生插入一個新文件

db.students.insert(
    {
        first_name: "Ashley",
        last_name: "Jenkins",
        dob: new Date("January 08, 2003"),
        grade_level: 8
    }
)

WriteResult({ "nInserted" : 1 })

如果您想要同時插入多個文件，請傳遞文件陣列而不是將文件傳遞給 insert()。我們可以為名為 Brian 和 Leah 的學生新增兩個新文件

db.students.insert(
    [
        {
            first_name: "Brian",
            last_name: "McMantis",
            dob: new Date("September 18, 2010"),
            grade_level: 2
        },
        {
            first_name: "Leah",
            last_name: "Drake",
            dob: new Date("October 03, 2009")
        }
    ]
)

BulkWriteResult({
        "writeErrors" : [ ],
        "writeConcernErrors" : [ ],
        "nInserted" : 2,
        "nUpserted" : 0,
        "nMatched" : 0,
        "nModified" : 0,
        "nRemoved" : 0,
        "upserted" : [ ]
})

由於我們執行了大量寫入操作，因此我們的傳回值是 BulkWriteResult，而不是我們之前看到的 WriteResult 物件。

雖然 insert() 方法很靈活，但在許多 MongoDB 驅動程式中已被棄用，取而代之的是以下兩種方法。

使用 insertOne() 方法

insertOne() 方法可用於插入單個文件。與 insert() 方法不同，它一次只能插入一個文件，這使其行為更具可預測性。

語法與您使用 insert() 新增單個文件時相同。我們可以新增另一位名為 Naomi 的學生

db.students.insertOne(
    {
        first_name: "Naomi",
        last_name: "Pyani"
    }
)

{
        "acknowledged" : true,
        "insertedId" : ObjectId("60e877914655cbf49ff7cb86")
}

與 insert() 不同，insertOne() 方法傳回一個包含一些其他有用資訊的文件。它確認叢集已確認寫入，並且包含分配給文件的物件 ID，因為我們沒有提供一個。

使用 insertMany() 方法

為了涵蓋您想要一次插入多個文件的情況，現在建議使用 insertMany() 方法。就像使用 insert() 插入多個文件一樣，insertMany() 接受文件陣列。

我們可以新增三位名為 Jasmine、Michael 和 Toni 的新學生

db.students.insertMany(
    [
        {
            first_name: "Jasmine",
            last_name: "Took",
            dob: new Date("April 11, 2011")
        },
        {
            first_name: "Michael",
            last_name: "Rodgers",
            dob: new Date("February 25, 2008"),
            grade_level: 6
        },
        {
            first_name: "Toni",
            last_name: "Fowler"
        }
    ]
)

{
        "acknowledged" : true,
        "insertedIds" : [
                ObjectId("60e8792d4655cbf49ff7cb87"),
                ObjectId("60e8792d4655cbf49ff7cb88"),
                ObjectId("60e8792d4655cbf49ff7cb89")
        ]
}

與 insertOne() 一樣，insertMany() 傳回一個文件，該文件確認寫入並提供一個陣列，其中包含已分配給插入文件的 ID。

更新運算符

在我們查看更新文件的每種方法之前，我們應該先了解一些可用的更新運算符。

• $currentDate：將欄位的值設定為目前日期，可以是日期或時間戳記類型。
  • 語法：{ $currentDate: { <欄位>: <類型>, ... } }
• $inc：將欄位的值遞增設定的量。
  • 語法：{ $inc: { <欄位>: <數量>, ... } }
• $min：如果指定的值小於目前值，則更新欄位的值。
  • 語法：{ $min: { <欄位>: <值>, ... } }
• $max：如果指定的值大於目前值，則更新欄位的值。
  • 語法：{ $max: { <欄位>: <值>, ... } }
• $mul：透過將欄位的值乘以給定的數字來更新它。
  • 語法：{ $mul: { <欄位>: <值>, ... } }
• $rename：將欄位名稱重新命名為新的識別符。
  • 語法：{ $rename: { <欄位>: <新名稱>, ... } }
• $set：將欄位的值替換為給定的值。
  • 語法：{ $set: { <欄位>: 值, ... } }
• $setOnInsert：在 upsert 操作期間，如果正在建立新文件，則設定欄位的值，否則不執行任何操作。
  • 語法：{ $setOnInsert: { <欄位>: <值>, ... } }
• $unset：從文件中移除欄位。
  • 語法：{ $unset: { <欄位>: "", ... } }
• $：滿足查詢的第一個陣列元素的佔位符。
  • 語法：{ <更新運算符>: {<陣列>.$: <值> } }
• $[]：滿足查詢的所有陣列元素的佔位符。
  • 語法：{ <更新運算符>: { <陣列>.$[]: <值> } }
• $addToSet：將值新增到陣列，除非它們已存在。
  • 語法：{ $addToSet: { <欄位>: <值>, ... } }
• $pop：移除陣列的第一個或最後一個元素。
  • 語法：{ $pop: { <欄位>: (-1 或 1), ... } }
• $pull：移除陣列中符合條件的所有元素。
  • 語法：{ $pull: { <欄位>: <條件>, ... } }
• $push：將值附加到陣列。
  • 語法：{ $push: { <欄位>: <值>, ... } }
• $pullAll：從陣列中移除所有指定的元素。
  • 語法：{ $pullAll: { <欄位>: [ <值>, ... ], ...} }
• $each：修改 $addToSet 和 $push 運算符，以便它們新增陣列的每個元素，而不是將陣列作為單個元素新增。
  • 語法：{ <更新運算符>: { <欄位>: { $each: [ <值>, ... ] }, ... } }
• $position：與 $each 一起使用，並指定 $push 運算符應插入的位置。
  • 語法：{ $push: { <欄位>: { $each: [ <值>, ... ], $position: <數字> } } }
• $slice：與 $each 和 $push 一起使用，以限制陣列中元素的總數。
  • 語法：{ $push: { <欄位>: { $each: [ <值>, ... ], $slice: <數字> } } }
• $sort：與 $each 和 $push 一起使用，以排序陣列元素。
  • 語法：{ $push: { <欄位>: { $each: [ <值>, ... ], $sort: <排序順序> } } }

這些各種更新運算符允許您以不同的方式更新文件的各種欄位。

更新集合中的單個文件

MongoDB 的 updateOne() 方法用於更新集合中的單個文件。該方法接受兩個必需的參數以及一個指定可選參數的文件。

第一個參數是一個文件，用於指定將用於選擇文件的篩選條件。由於 updateOne() 方法最多修改集合中的一個文件，因此將使用第一個滿足篩選條件的文件。

第二個參數指定應執行的更新操作。可以在此處指定上面給出的更新操作，以更改匹配文件的內容。

第三個參數是一個包含各種選項的文件，用於修改方法的行為。最重要的潛在值是

• upsert：如果篩選器與任何現有文件不匹配，則透過插入新文件將操作變成 upsert 程序。
• collation：一個文件，用於定義應適用於操作的特定語言規則。

作為範例，我們可以更新單個學生記錄，我們透過 _id 欄位對其進行篩選，以確保我們針對正確的文件。我們可以將 grade_level 設定為新值

db.students.updateOne(
    { _id: ObjectId("60e8792d4655cbf49ff7cb89") },
    { $set: { grade_level: 3 } }
)

{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 }

更新集合中的多個文件

MongoDB 的 updateMany() 方法的工作方式與 updateOne() 方法類似，但它會更新任何符合給定篩選器的文件，而不是在第一次匹配後停止。

updateMany() 語法完全遵循 updateOne() 語法，因此唯一的區別是操作的範圍。

作為範例，如果我們想要將 teachers 集合文件中 subjects 陣列中的所有 "composition" 實例更改為 "writing"，我們可以使用類似這樣的方式

db.teachers.updateMany(
    { subject: "composition" },
    { $set: { "subjects.$": "writing" } }
)

{ "acknowledged" : true, "matchedCount" : 3, "modifiedCount" : 3 }

如果您檢查文件，則每個 "composition" 實例都應已替換為 "writing"

db.teachers.find()

{ "_id" : ObjectId("60eddca65eb74f5c676f3baa"), "first_name" : "Nancy", "last_name" : "Smith", "subjects" : [ "vocabulary", "pronunciation" ] }
{ "_id" : ObjectId("60eddca65eb74f5c676f3bab"), "first_name" : "Ronald", "last_name" : "Taft", "subjects" : [ "literature", "grammar", "writing" ] }
{ "_id" : ObjectId("60eddca65eb74f5c676f3bac"), "first_name" : "Casey", "last_name" : "Meyers", "subjects" : [ "literature", "writing", "grammar" ] }
{ "_id" : ObjectId("60eddca65eb74f5c676f3bad"), "first_name" : "Rebecca", "last_name" : "Carrie", "subjects" : [ "grammar", "literature" ] }
{ "_id" : ObjectId("60eddca65eb74f5c676f3bae"), "first_name" : "Sophie", "last_name" : "Daggs", "subjects" : [ "literature", "writing", "grammar", "vocabulary", "pronunciation" ] }

替換文件

replaceOne() 方法的工作方式與 updateOne() 方法類似，但它會替換整個文件，而不是更新個別欄位。語法與前兩個命令相同。

例如，如果 Nancy Smith 離開您的學校，並且您用一位名叫 Clara Newman 的文學老師替換她，您可以輸入以下內容

db.teachers.replaceOne(
    {
        $and: [
            { first_name: "Nancy" },
            { last_name: "Smith" }
        ]
    },
    {
        first_name: "Clara",
        last_name: "Newman",
        subjects: [ "literature" ]
    }
)

{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 }

您可以看到匹配的文件已被移除，並且指定的文件已替換它

db.teachers.find()

{ "_id" : ObjectId("60eddca65eb74f5c676f3baa"), "first_name" : "Clara", "last_name" : "Newman", "subjects" : [ "literature" ] }
{ "_id" : ObjectId("60eddca65eb74f5c676f3bab"), "first_name" : "Ronald", "last_name" : "Taft", "subjects" : [ "literature", "grammar", "writing" ] }
{ "_id" : ObjectId("60eddca65eb74f5c676f3bac"), "first_name" : "Casey", "last_name" : "Meyers", "subjects" : [ "literature", "writing", "grammar" ] }
{ "_id" : ObjectId("60eddca65eb74f5c676f3bad"), "first_name" : "Rebecca", "last_name" : "Carrie", "subjects" : [ "grammar", "literature" ] }
{ "_id" : ObjectId("60eddca65eb74f5c676f3bae"), "first_name" : "Sophie", "last_name" : "Daggs", "subjects" : [ "literature", "writing", "grammar", "vocabulary", "pronunciation" ] }