MongoDBで配列内の要素数をカウントする方法（$size演算子の使い方）

MongoDBで配列に格納されている要素の数を取得したい場合は、アグリゲーションフレームワークと $size 演算子を組み合わせて使用します。この記事では、実際のコード例を通じて、配列内の要素数をカウントする手順をわかりやすく解説します。

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

まず、配列フィールドを持つドキュメントを含むコレクションを作成します。以下では insertOne() メソッドを使って、UserMessage という配列フィールドを持つドキュメントを挿入しています。

> db.countNumberOfElementsDemo.insertOne({"UserMessage":["Hi","Hello","Bye","Awesome"]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cef8ec2ef71edecf6a1f6a1")
}

2. 挿入したドキュメントの確認

find() メソッドと pretty() を組み合わせることで、コレクション内のすべてのドキュメントを見やすい形式で表示できます。

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

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

{
   "_id" : ObjectId("5cef8ec2ef71edecf6a1f6a1"),
   "UserMessage" : [
      "Hi",
      "Hello",
      "Bye",
      "Awesome"
   ]
}

3. 配列内の要素数をカウントするクエリ

それでは、配列内の要素数をカウントしてみましょう。aggregate() メソッドのパイプライン内で $project ステージを使用し、その中で $size 演算子を適用します。

> db.countNumberOfElementsDemo.aggregate({$project: { NumberOfElements: { $size:"$UserMessage" }}})

実行結果は以下のとおりです。UserMessage 配列には4つの文字列が格納されているため、NumberOfElements フィールドに「4」が出力されます。

{ "_id" : ObjectId("5cef8ec2ef71edecf6a1f6a1"), "NumberOfElements" : 4 }

ポイントのまとめ

• $size 演算子：配列フィールドを受け取り、その要素数を整数として返します。
• $project ステージ：出力するフィールドを指定・整形するために使用します。ここでは元の _id と計算結果の NumberOfElements のみを出力しています。
• 注意点：$size の引数は必ず配列である必要があります。配列以外のフィールドや存在しないフィールドを指定するとエラーになるため、必要に応じて $isArray や $ifNull と組み合わせて安全に処理するとよいでしょう。

このように、アグリゲーションパイプラインと $size を使えば、MongoDBの配列内要素数を簡単かつ効率的にカウントできます。大量のドキュメントを扱う場合でも、サーバー側で一括処理できるため、アプリケーション側で配列を展開して数えるよりもパフォーマンス面で有利です。