条件なしでMongoDBの配列からすべての要素を一括削除する方法

$set演算子を使って配列の全要素を削除する

MongoDBで、条件を指定せずに配列からすべての要素を取り除きたい場合、$set演算子を使用するのが簡単です。$pull演算子は特定の条件に一致する要素のみを削除しますが、$setで空の配列を代入することで、配列の中身をまとめてクリアできます。

この記事では、実際にコレクションを作成し、配列の全要素を削除する手順を順番に解説します。

1. ドキュメントを含むコレクションを作成する

まず、insertOne()メソッドを使ってサンプル用のコレクションを作成しましょう。ここでは学生情報を格納したドキュメントを2件登録します。

> db.pullAllElementDemo.insertOne(
...    {
...       "StudentId":101,
...       "StudentDetails" : [
...          {
...             "StudentName": "Carol",
...             "StudentAge":21,
...             "StudentCountryName":"US"
...          },
...          {
...             "StudentName": "Chris",
...             "StudentAge":24,
...             "StudentCountryName":"AUS"
...          }
...       ]
...    }
... );
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5ccdd9c8685b30d09a7111e4")
}
> db.pullAllElementDemo.insertOne(
...    {
...       "StudentId":102,
...       "StudentDetails" : [
...          {
...             "StudentName": "Robert",
...             "StudentAge":27,
...             "StudentCountryName":"UK"
...          },
...          {
...             "StudentName": "David",
...             "StudentAge":23,
...             "StudentCountryName":"US"
...          }
...       ]
...    }
... );
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5ccdd9f7685b30d09a7111e5")
}

2. 登録したドキュメントを確認する

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

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

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

{
   "_id" : ObjectId("5ccdd9c8685b30d09a7111e4"),
   "StudentId" : 101,
   "StudentDetails" : [
      {
         "StudentName" : "Carol",
         "StudentAge" : 21,
         "StudentCountryName" : "US"
      },
      {
         "StudentName" : "Chris",
         "StudentAge" : 24,
         "StudentCountryName" : "AUS"
      }
   ]
}
{
   "_id" : ObjectId("5ccdd9f7685b30d09a7111e5"),
   "StudentId" : 102,
   "StudentDetails" : [
      {
         "StudentName" : "Robert",
         "StudentAge" : 27,
         "StudentCountryName" : "UK"
      },
      {
         "StudentName" : "David",
         "StudentAge" : 23,
         "StudentCountryName" : "US"
      }
   ]
}

3. $set演算子で配列の全要素を削除する

それでは、条件なしで配列からすべての要素を取り除くクエリを見ていきましょう。ここでは、StudentIdが「102」のドキュメントに対して、$set演算子でStudentDetailsフィールドに空の配列を代入し、中身をすべて削除します。

> db.pullAllElementDemo.update( {StudentId:102}, { "$set": { "StudentDetails": [] }} );
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

実行結果のWriteResultでは、「nMatched: 1」「nModified: 1」と表示されており、1件のドキュメントが正常に更新されたことがわかります。

4. 削除結果を確認する

もう一度find()メソッドですべてのドキュメントを表示し、指定した配列の要素が正しく削除されているか確認しましょう。

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

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

{
   "_id" : ObjectId("5ccdd9c8685b30d09a7111e4"),
   "StudentId" : 101,
   "StudentDetails" : [
      {
         "StudentName" : "Carol",
         "StudentAge" : 21,
         "StudentCountryName" : "US"
      },
      {
         "StudentName" : "Chris",
         "StudentAge" : 24,
         "StudentCountryName" : "AUS"
      }
   ]
}
{
   "_id" : ObjectId("5ccdd9f7685b30d09a7111e5"),
   "StudentId" : 102,
   "StudentDetails" : [ ]
}

出力結果を見ると、StudentId「102」のドキュメントにあるStudentDetails配列が空になっていることが確認できます。このように、$set演算子で空の配列を代入するだけで、条件を一切指定せずに配列内の全要素を一括で削除できます。

補足：update()とupdateOne()について

上記の例ではupdate()メソッドを使用していますが、最近のMongoDB（バージョン4.2以降）では、1件だけ更新する場合はupdateOne()、条件に一致するすべてのドキュメントを更新する場合はupdateMany()の使用が推奨されています。

> db.pullAllElementDemo.updateOne(
...    { StudentId: 102 },
...    { $set: { "StudentDetails": [] } }
... );

状況に応じて適切なメソッドを選択することで、より安全で意図通りの更新処理を実現できます。