如何在 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，它包含了分配給該文件的物件 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: { <field>: <type>, ... } }
• $inc：將欄位的值增加一個設定量。
  • 語法: { $inc: { <field>: <amount>, ... } }
• $min：如果指定值小於當前值，則更新欄位的值。
  • 語法: { $min: { <field>: <value>, ... } }
• $max：如果指定值大於當前值，則更新欄位的值。
  • 語法: { $max: { <field>: <value>, ... } }
• $mul：將欄位的值乘以給定數字來更新它。
  • 語法: { $mul: { <field>: <value>, ... } }
• $rename：將欄位名稱重新命名為新識別符號。
  • 語法: { $rename: { <field>: <new_name>, ... } }
• $set：用給定值替換欄位的值。
  • 語法: { $set: { <field>: value, ... } }
• $setOnInsert：在 upsert 操作期間，如果正在建立新文件，則設定欄位的值；否則不執行任何操作。
  • 語法: { $setOnInsert: { <field>: <value>, ... } }
• $unset：從文件中刪除欄位。
  • 語法: { $unset: { <field>: "", ... } }
• $：滿足查詢的第一個陣列元素的佔位符。
  • 語法: { <update_operator>: {<array>.$: <value> } }
• $[]：滿足查詢的所有陣列元素的佔位符。
  • 語法: { <update_operator>: { <array>.$[]: <value> } }
• $addToSet：向陣列新增值，除非這些值已存在。
  • 語法: { $addToSet: { <field>: <value>, ... } }
• $pop：刪除陣列的第一個或最後一個元素。
  • 語法: { $pop: { <field>: (-1 或 1), ... } }
• $pull：刪除陣列中所有匹配條件的元素。
  • 語法: { $pull: { <field>: <condition>, ... } }
• $push：向陣列追加一個值。
  • 語法: { $push: { <field>: <value>, ... } }
• $pullAll：從陣列中刪除所有指定元素。
  • 語法: { $pullAll: { <field>: [ <value>, ... ], ...} }
• $each：修改 $addToSet 和 $push 運算子，使它們新增陣列的每個元素，而不是將整個陣列作為一個單一元素新增。
  • 語法: { <update_operator>: { <field>: { $each: [ <value>, ... ] }, ... } }
• $position：與 $each 結合使用，指定 $push 運算子應插入的位置。
  • 語法: { $push: { <field>: { $each: [ <value>, ... ], $position: <num> } } }
• $slice：與 $each 和 $push 結合使用，限制陣列中元素的總數。
  • 語法: { $push: { <field>: { $each: [ <value>, ... ], $slice: <num> } } }
• $sort：與 $each 和 $push 結合使用，對陣列元素進行排序。
  • 語法: { $push: { <field>: { $each: [ <value>, ... ], $sort: <sort_order> } } }

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

更新集合中的單個文件

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" ] }