MongoDBで配列フィールドの最初の要素だけを取得する方法（$slice演算子の使い方）

MongoDBでは、配列型のフィールドから最初の要素だけを取り出したいケースがよくあります。そんなときに便利なのが $slice 演算子です。この記事では、実際のコード例をもとに、$slice演算子を使って配列の先頭要素のみを取得する手順をわかりやすく解説します。

1. サンプル用のコレクションを作成する

まずは、ドキュメントを含むコレクションを作成しましょう。ここでは「gettingFirstItemInArrayDemo」というコレクションに、ユーザー情報と友人リスト（配列）を持つドキュメントを挿入します。

> db.gettingFirstItemInArrayDemo.insertOne(
   {
      "UserId": 101,
      "UserName":"Carol",
      "UserOtherDetails": [
         {"UserFriendName":"Sam"},
         {"UserFriendName":"Mike"},
         {"UserFriendName":"David"},
         {"UserFriendName":"Bob"}
      ]
   }
);
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cdfca52bf3115999ed51205")
}

挿入が成功すると、「acknowledged : true」が返され、ドキュメントが正しく登録されたことが確認できます。

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

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

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

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

{
   "_id" : ObjectId("5cdfca52bf3115999ed51205"),
   "UserId" : 101,
   "UserName" : "Carol",
   "UserOtherDetails" : [
      {
         "UserFriendName" : "Sam"
      },
      {
         "UserFriendName" : "Mike"
      },
      {
         "UserFriendName" : "David"
      },
      {
         "UserFriendName" : "Bob"
      }
   ]
}

「UserOtherDetails」フィールドには、4件の友人情報が配列として格納されていることがわかります。

3. $slice演算子で配列の最初の要素のみを取得する

それでは本題です。配列プロパティから最初の要素だけを取得するには、find()メソッドの第2引数（射影）で {$slice: 1} を指定します。

> db.gettingFirstItemInArrayDemo.find({"UserId":101}, {UserOtherDetails:{$slice: 1}});

実行結果は以下のとおりです。

{ "_id" : ObjectId("5cdfca52bf3115999ed51205"), "UserId" : 101, "UserName" : "Carol", "UserOtherDetails" : [ { "UserFriendName" : "Sam" } ] }

「UserOtherDetails」配列から最初の要素である「Sam」だけが取得できました。

ポイントまとめ

• $slice: 1 を指定すると、配列の先頭から1件だけが返されます。
• $slice: -1 とすると、逆に配列の末尾の要素を取得できます。
• $slice: [スキップ数, 取得件数] の形式を使えば、任意の範囲の要素を柔軟に取り出すことも可能です。

このように、$slice演算子を使えばクエリ側で配列の要素数を制御できるため、アプリケーション側で不要なデータを受け取らずに済み、通信量やメモリの節約にもつながります。配列フィールドを扱う際はぜひ活用してみてください。