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 が含まれています。

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: upsert 操作中に、新しいドキュメントが作成される場合にのみフィールドの値を設定し、それ以外の場合は何もしません。
  • 構文: { $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: フィルターがいずれの既存ドキュメントとも一致しない場合に新しいドキュメントを挿入することで、操作を 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 つのコマンドと同じです。

たとえば、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" ] }