MongoDBで配列の要素を削除するには？$pull演算子の使い方を解説

MongoDBで配列から要素を削除する基本

MongoDBで配列内の要素を削除したい場合は、$pull演算子を使用します。$pullは、既存の配列から指定した値、または条件に一致するすべてのインスタンスを取り除くための更新演算子です。

この記事では、実際にコレクションを作成し、ネストされた配列から特定の要素を削除する手順を順番に解説します。

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

まず、ドキュメントを含むコレクションを作成しましょう。ここでは「software」フィールドの中に「services」という配列を持つドキュメントを挿入します。

db.demo541.insertOne({"software":{"services":["gmail","facebook","yahoo"]}});{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e8ca845ef4dcbee04fbbc11")
}
> db.demo541.insertOne({"software":{"services":["whatsapp","twitter"]}});{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e8ca85cef4dcbee04fbbc12")
}

find()メソッドでドキュメントを確認する

挿入したすべてのドキュメントを表示するには、find()メソッドを使用します。

> db.demo541.find();

実行すると、以下のような出力が得られます。

{ "_id" : ObjectId("5e8ca845ef4dcbee04fbbc11"), "software" : { "services" : [ "gmail", "facebook", "yahoo" ] } }
{ "_id" : ObjectId("5e8ca85cef4dcbee04fbbc12"), "software" : { "services" : [ "whatsapp", "twitter" ] } }

$pullを使って配列の要素を削除する

それでは、MongoDBの配列から要素を削除するクエリを見ていきましょう。以下の例では、ObjectIdが「5e8ca845ef4dcbee04fbbc11」のドキュメントから、「yahoo」という値をservices配列から削除しています。

> db.demo541.update({ _id: ObjectId("5e8ca845ef4dcbee04fbbc11") },
...    { $pull: { 'software.services': "yahoo" }}
... );
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

ポイントは、ネストされたフィールドに対してドット記法（software.services）でパスを指定している点です。これにより、入れ子になったオブジェクト内の配列も正しく操作できます。

削除後の結果を確認する

再度find()メソッドを実行して、すべてのドキュメントを表示してみましょう。

> db.demo541.find();

出力結果は以下の通りです。「yahoo」が配列から正常に削除されていることが確認できます。

{ "_id" : ObjectId("5e8ca845ef4dcbee04fbbc11"), "software" : { "services" : [ "gmail", "facebook" ] } }
{ "_id" : ObjectId("5e8ca85cef4dcbee04fbbc12"), "software" : { "services" : [ "whatsapp", "twitter" ] } }

補足：updateOne()と$pullAllについて

なお、上記の例で使用しているupdate()メソッドは非推奨となっているため、現在のバージョンのMongoDBではupdateOne()やupdateMany()の使用が推奨されています。書き方はほぼ同じです。

db.demo541.updateOne(
   { _id: ObjectId("5e8ca845ef4dcbee04fbbc11") },
   { $pull: { 'software.services': "yahoo" } }
);

また、複数の値をまとめて削除したい場合は、$pullAll演算子が便利です。条件マッチングではなく、指定した値のリストに一致する要素をすべて削除します。

db.demo541.updateOne(
   { _id: ObjectId("5e8ca845ef4dcbee04fbbc11") },
   { $pullAll: { 'software.services': ["gmail", "facebook"] } }
);

まとめ

MongoDBで配列の要素を削除するには、$pull演算子を使うのが基本です。単一の値でも条件式でも柔軟に対応でき、ドット記法を組み合わせればネストされた配列にも適用できます。最新の環境ではupdateOne()/updateMany()を使うことを忘れないようにしましょう。