MongoDBの$push演算子を使って条件に一致する配列要素を更新する方法

MongoDBの$push演算子で条件に一致する配列要素を更新する方法

MongoDBでは、updateコマンドと$push演算子を組み合わせることで、条件に一致する配列要素を更新できます。$pushは配列の末尾に新しい値を追加するための更新演算子であり、位置指定演算子「$」と併用することで、クエリ条件に一致した特定の配列要素だけをピンポイントで操作することが可能です。

1. コレクションの作成

まずは、insertOne()メソッドを使ってサンプル用のコレクションを作成します。

> db.demo9.insertOne({"StudentDetails":[{"StudentName":"Chris","ListOfSubject":["MySQL","Java"]}]});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5e0f6438d7df943a7cec4f94")
}

2. ドキュメントの確認

find()メソッドを実行して、コレクション内のすべてのドキュメントを表示してみましょう。

> db.demo9.find().pretty();

上記のクエリを実行すると、次のような出力が得られます。

{
    "_id" : ObjectId("5e0f6438d7df943a7cec4f94"),
    "StudentDetails" : [
        {
            "StudentName" : "Chris",
            "ListOfSubject" : [
                "MySQL",
                "Java"
            ]
        }
    ]
}

3. $pushによる配列要素の更新

ここからが本題です。次のクエリでは、「StudentName」が「Chris」と一致する配列要素に対して、位置指定演算子「$」を使って「MongoDB」という科目をListOfSubject配列に追加しています。

> db.demo9.update( { "StudentDetails.StudentName":"Chris"}, {$push:{"StudentDetails.$.ListOfSubject":"MongoDB"}});
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

実行結果の「nMatched : 1」「nModified : 1」という値から、1件のドキュメントが正常に更新されたことがわかります。

4. 更新結果の確認

再度find()メソッドを実行して、更新後のドキュメントを確認します。

> db.demo9.find().pretty();

出力結果は以下の通りです。

{
    "_id" : ObjectId("5e0f6438d7df943a7cec4f94"),
    "StudentDetails" : [
        {
            "StudentName" : "Chris",
            "ListOfSubject" : [
                "MySQL",
                "Java",
                "MongoDB"
            ]
        }
    ]
}

このように、条件に一致した学生（Chris）の科目リストに「MongoDB」が正しく追加されました。

補足：位置指定演算子「$」の役割

「StudentDetails.$.ListOfSubject」のようにフィールドパスに「$」を指定すると、クエリ条件に最初に一致した配列要素が自動的に参照されます。そのため、更新対象の要素をインデックス番号で明示的に指定する必要がなく、ネストされた配列構造でも柔軟かつ安全に更新処理を行えます。なお、新しいバージョンのMongoDBでは、update()メソッドの代わりにupdateOne()やupdateMany()を使用することが推奨されています。