MongoDBでmultiオプションをtrueに設定して配列に値を追加する方法

配列に値を追加（プッシュ）するには、update()メソッドと$push演算子を組み合わせて使用し、第3引数のmultiオプションをtrueに設定します。これにより、検索条件に一致したすべてのドキュメントに対して、一括で値を追加することが可能になります。

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

まず、ドキュメントを格納したコレクションを作成しましょう。

> db.demo747.insertOne({"CountryName":["US","IND"]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5eae6a50a930c785c834e55f")
}
> db.demo747.insertOne({"CountryName":["UK","US"]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5eae6a57a930c785c834e560")
}
> db.demo747.insertOne({"CountryName":["UK","IND"]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5eae6a60a930c785c834e561")
}

2. ドキュメントの確認

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

> db.demo747.find();

上記のコマンドを実行すると、次のような出力が得られます。

{ "_id" : ObjectId("5eae6a50a930c785c834e55f"), "CountryName" : [ "US", "IND" ] }
{ "_id" : ObjectId("5eae6a57a930c785c834e560"), "CountryName" : [ "UK", "US" ] }
{ "_id" : ObjectId("5eae6a60a930c785c834e561"), "CountryName" : [ "UK", "IND" ] }

3. $pushとmultiオプションによる一括更新

続いて、update()で$pushを実装するための正しいクエリを見ていきましょう。検索条件として空のドキュメント「{}」を指定し、「{multi:true}」を渡すことで、コレクション内のすべてのドキュメントのCountryName配列に「AUS」が追加されます。

> db.demo747.update({},{$push:{CountryName:"AUS"}},{multi:true});
WriteResult({ "nMatched" : 3, "nUpserted" : 0, "nModified" : 3 })

実行結果から、3件のドキュメントが条件に一致し（nMatched: 3）、3件すべてが更新されたこと（nModified: 3）が確認できます。

4. 更新後のドキュメント確認

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

> db.demo747.find();

上記のコマンドを実行すると、次のような出力が得られます。

{ "_id" : ObjectId("5eae6a50a930c785c834e55f"), "CountryName" : [ "US", "IND", "AUS" ] }
{ "_id" : ObjectId("5eae6a57a930c785c834e560"), "CountryName" : [ "UK", "US", "AUS" ] }
{ "_id" : ObjectId("5eae6a60a930c785c834e561"), "CountryName" : [ "UK", "IND", "AUS" ] }

このように、multiオプションをtrueに設定することで、条件に一致したすべてのドキュメントの配列に対して、$pushによる値の追加を一度の操作で実行できます。なお、multiオプションを指定しない場合（デフォルトはfalse）は、最初に一致した1件のドキュメントしか更新されない点に注意してください。