MongoDBの配列に追加・連結するには？$concatArrays演算子の使い方

MongoDBで配列を追加・連結するには？

MongoDBで配列に別の配列を追加（連結）したい場合には、集計（アグリゲーション）フレームワークの$concatArrays演算子を使用します。$concatArraysは、複数の配列を1つに結合した新しい配列を返す演算子で、MongoDB 3.2以降で利用可能です。

この記事では、実際にコレクションを作成し、「FirstName」と「LastName」という2つの配列フィールドを$concatArraysで連結するまでの手順を、サンプルコードとともに解説します。

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

まず、insertOne()メソッドを使ってドキュメントを挿入し、コレクションを作成しましょう。

> db.demo435.insertOne({"FirstName":["Chris"],"LastName":["Brown"]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e7719b1bbc41e36cc3cae97")
}
> db.demo435.insertOne({"FirstName":["David"],"LastName":["Miller"]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e7719bdbbc41e36cc3cae98")
}
> db.demo435.insertOne({"FirstName":["John"],"LastName":["Doe"]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e7719c6bbc41e36cc3cae99")
}

2. 登録されたドキュメントの確認

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

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

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

{
   "_id" : ObjectId("5e7719b1bbc41e36cc3cae97"),
   "FirstName" : [
      "Chris"
   ],
   "LastName" : [
      "Brown"
   ]
}
{
   "_id" : ObjectId("5e7719bdbbc41e36cc3cae98"),
   "FirstName" : [
      "David"
   ],
   "LastName" : [
      "Miller"
   ]
}
{
   "_id" : ObjectId("5e7719c6bbc41e36cc3cae99"),
   "FirstName" : [
      "John"
   ],
   "LastName" : [
      "Doe"
   ]
}

3. $concatArraysで配列を連結する

MongoDBで配列を追加（連結）するためのクエリは以下の通りです。aggregate()メソッド内の$projectステージで、$concatArraysを使って2つの配列フィールドを結合しています。

> db.demo435.aggregate([
   { $project: { FullName: { $concatArrays: [ "$FirstName", "$LastName" ] } } }
])

実行すると、「FullName」という新しいフィールドに、連結された配列が出力されます。

{ "_id" : ObjectId("5e7719b1bbc41e36cc3cae97"), "FullName" : [ "Chris", "Brown" ] }
{ "_id" : ObjectId("5e7719bdbbc41e36cc3cae98"), "FullName" : [ "David", "Miller" ] }
{ "_id" : ObjectId("5e7719c6bbc41e36cc3cae99"), "FullName" : [ "John", "Doe" ] }

$concatArrays使用時の注意点

• $concatArraysは集計時に新しい配列を生成するだけで、元のドキュメントは変更されません。
• 引数のいずれかがnull、またはフィールドが存在しない場合、結果はnullになります。
• 既存ドキュメントの配列フィールドそのものに要素を追加・更新したい場合は、update系メソッドの$pushや$addToSet演算子を使用してください。