MongoDBで配列の要素を削除する方法｜$pullと$in演算子の使い方を解説

MongoDBでドキュメント内の配列から特定の要素を削除したい場合、$pull演算子と$in演算子を組み合わせて使用するのが一般的です。この記事では、基本構文から実際のコレクションを使った実行例まで、手順を追ってわかりやすく解説します。

配列要素を削除するための基本構文

複数の配列から同時に要素を削除する場合の基本構文は以下のとおりです。

db.yourCollectionName.update({},
    {$pull:{yourFirstArrayName:{$in:["yourValue"]},yourSecondArrayName:"yourValue"}},
    {multi:true}
);

各オプションの意味は次のとおりです。

• $pull: 指定した条件に一致する要素を配列から取り除きます。
• $in: 複数の値を配列で指定し、いずれかに一致する要素をまとめて削除できます。単一の値であれば省略可能です。
• {multi:true}: 条件に一致したすべてのドキュメントに更新を適用します（指定しない場合は最初の1件のみ）。

サンプルコレクションの作成

それでは、実際に動作を確認してみましょう。まずはテスト用のコレクションを作成します。次のクエリを実行してドキュメントを挿入してください。

> db.removeArrayElement.insertOne({"StudentName":"Larry","StudentCoreSubject":["MongoDB","MySQL","SQL Server","Java"],"StudentFavouriteTeacher":["John","Marry","Carol"]});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5c6ec9c46fd07954a4890688")
}

このドキュメントには、学生名（StudentName）、専攻科目の配列（StudentCoreSubject）、好きな先生の配列（StudentFavouriteTeacher）が含まれています。

挿入したデータの確認

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

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

実行結果は以下のとおりです。

{
    "_id" : ObjectId("5c6ec9c46fd07954a4890688"),
    "StudentName" : "Larry",
    "StudentCoreSubject" : [
        "MongoDB",
        "MySQL",
        "SQL Server",
        "Java"
    ],
    "StudentFavouriteTeacher" : [
        "John",
        "Marry",
        "Carol"
    ]
}

配列要素を削除するクエリの実行

準備ができたら、実際に要素を削除してみましょう。1つ目の配列「StudentCoreSubject」から「Java」を、2つ目の配列「StudentFavouriteTeacher」から「Marry」を削除するクエリが次のとおりです。

> db.removeArrayElement.update({},
... {$pull:{StudentCoreSubject:{$in:["Java"]},StudentFavouriteTeacher:"Marry"}},
... {multi:true}
... );
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

ここでは、最初の配列（StudentCoreSubject）からは「Java」を$in演算子経由で指定し、2つ目の配列（StudentFavouriteTeacher）からは「Marry」を直接指定しています。このように、$pullの中では複数の配列フィールドに対して異なる条件を同時に設定できます。

削除結果の確認

再度find()メソッドを実行して、要素が正しく削除されたか確認しましょう。

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

実行結果は以下のとおりです。

{
    "_id" : ObjectId("5c6ec9c46fd07954a4890688"),
    "StudentName" : "Larry",
    "StudentCoreSubject" : [
        "MongoDB",
        "MySQL",
        "SQL Server"
    ],
    "StudentFavouriteTeacher" : [
        "John",
        "Carol"
    ]
}

出力結果を見ると、1つ目の配列（StudentCoreSubject）からは「Java」が、2つ目の配列（StudentFavouriteTeacher）からは「Marry」が消えていることが確認できます。これで、コレクションから目的の配列要素を正常に削除できました。

補足：新しいバージョンのMongoDBでの注意点

MongoDB 4.2以降では、update()メソッドは非推奨（deprecated）となっており、代わりにupdateMany()やupdateOne()の使用が推奨されています。すべてのドキュメントに適用する場合、{multi:true}の代わりにupdateMany()を使うと、より意図が明確なコードになります。

db.removeArrayElement.updateMany({},
    {$pull:{StudentCoreSubject:{$in:["Java"]},StudentFavouriteTeacher:"Marry"}}
);

まとめ

MongoDBで配列要素を削除するには、$pull演算子を使用します。$in演算子と組み合わせれば複数の値を一括で削除でき、{multi:true}（またはupdateMany()）を指定すればすべてのドキュメントに同じ更新を適用できます。単一の配列だけでなく、複数の配列フィールドへの操作も1つのクエリで実行できるので、ぜひ活用してください。