MongoDBでドキュメントを管理する方法

insert()メソッドの使用

insert()メソッドを使用すると、1つまたは複数のドキュメントを呼び出されたコレクションに挿入できます。

単一のドキュメントを挿入するには、コレクションで呼び出すことによって、ドキュメントをメソッドに渡します。ここでは、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という名前の学生の新しいドキュメントを2つ追加できます。

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" : [ ]
})

バルク書き込み操作を実行したため、戻り値は、前に見たWriteResultオブジェクトではなく、BulkWriteResultになります。

insert()メソッドは柔軟性がありますが、多くのMongoDBドライバーで非推奨となり、次の2つのメソッドが推奨されています。

insertOne()メソッドの使用

insertOne()メソッドは、単一のドキュメントを挿入するために使用できます。insert()メソッドとは異なり、一度に1つのドキュメントしか挿入できないため、動作が少し予測しやすくなります。

構文は、単一のドキュメントを追加するためにinsert()を使用する場合と同じです。Naomiという名前の別の学生を追加できます。

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

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

insert()とは異なり、insertOne()メソッドは、いくつかの追加の有用な情報を含むドキュメントを返します。書き込みがクラスターによって承認されたことを確認し、オブジェクトIDが含まれています（オブジェクトIDは、こちらでIDを提供しなかったためドキュメントに割り当てられました）。

insertMany()メソッドの使用

複数のドキュメントを一度に挿入する場合のシナリオをカバーするために、insertMany()メソッドが推奨されるようになりました。insert()で複数のドキュメントを挿入する場合と同様に、insertMany()はドキュメントの配列を受け取ります。

Jasmine、Michael、Toniという名前の3人の新しい学生を追加できます。

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：アップサート操作中に、新しいドキュメントが作成されている場合はフィールドの値を設定し、それ以外の場合は何も実行しません。
  • 構文：{ $setOnInsert: { <field>: <value>, ... } }
• $unset：ドキュメントからフィールドを削除します。
  • 構文：{ $unset: { <field>: "", ... } }
• $：クエリを満たす最初の配列要素のプレースホルダー。
  • 構文：{ <update_operator>: {<array>.$: <value> } }
• $[]：クエリを満たすすべての配列要素のプレースホルダー。
  • 構文：{ <update_operator>: { <array>.$[]: <value> } }
• $addToSet：値がまだ存在しない場合に、配列に値を追加します。
  • 構文：{ $addToSet: { <field>: <value>, ... } }
• $pop：配列の最初または最後の要素を削除します。
  • 構文：{ $pop: { <field>: (-1 or 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()メソッドは、コレクション内の単一のドキュメントを更新するために使用されます。このメソッドは、2つの必須引数と、オプションの引数を指定するドキュメントを受け取ります。

最初の引数は、ドキュメントを選択するために使用されるフィルター条件を指定するドキュメントです。updateOne()メソッドはコレクション内で最大で1つのドキュメントを変更するため、フィルター条件を満たす最初のドキュメントが使用されます。

2番目の引数は、実行する必要がある更新操作を指定します。上記の更新操作は、ここで指定して、一致するドキュメントの内容を変更できます。

3番目の引数は、メソッドの動作を変更するためのさまざまなオプションのドキュメントです。最も重要な潜在的な値は次のとおりです。

• 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()メソッドと同様に機能しますが、個々のフィールドを更新するのではなく、ドキュメント全体を置き換えます。構文は、前の2つのコマンドと同じです。

たとえば、ナンシー・スミスが学校を辞めて、文学を教えるクララ・ニューマンという教師に置き換える場合は、次のように入力できます。

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