MongoDBの配列から特定の要素を取得する方法（$arrayElemAt演算子の使い方）

MongoDBの配列から特定の要素を取り出したい場合は、アグリゲーションフレームワーク（aggregate）を利用します。この記事では、実際にコレクションを作成しながら、$arrayElemAt演算子を使って配列内の任意の位置にある要素を取得する手順を、サンプルコード付きで解説します。

1. テスト用コレクションとドキュメントの作成

まず、動作を確認するためのコレクションを作成しましょう。以下のクエリを実行して、ドキュメントを挿入します。

> db.getParticularElement.insertOne({"InstructorName":"Larry","InstructorTechnicalSubject":["Java","C","C++","MongoDB","MySQL","SQL Server"]});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5c7ee027559dd2396bcfbfb1")
}

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

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

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

実行結果は以下のようになります。

{
    "_id" : ObjectId("5c7ee027559dd2396bcfbfb1"),
    "InstructorName" : "Larry",
    "InstructorTechnicalSubject" : [
        "Java",
        "C",
        "C++",
        "MongoDB",
        "MySQL",
        "SQL Server"
    ]
}

3. aggregateで配列から特定の要素を取得する

ここからが本題です。アグリゲーションパイプラインの$projectステージと$arrayElemAt演算子を組み合わせることで、配列から任意のインデックスの要素を取り出せます。以下は、配列の4番目の要素（インデックス3）を取得するクエリです。

> db.getParticularElement.aggregate([
    ... {
    ... $project:
    ... {
    ... ElementFromAnArray: 1,
    ... FourthElement: { $arrayElemAt: [ "$InstructorTechnicalSubject", 3] },
    ...
    ... }
    ... }
... ]);

実行結果：

{ "_id" : ObjectId("5c7ee027559dd2396bcfbfb1"), "FourthElement" : "MongoDB" }

ポイント解説

• インデックスは0始まり：$arrayElemAtの第2引数には、0から始まるインデックスを指定します。上記の例では「3」を指定しているため、配列の4番目の要素である「MongoDB」が返されています。
• 負のインデックスも利用可能：負の値を指定すると、配列の末尾から数えた位置の要素を取得できます。例えば「-1」を指定すれば、配列の最後の要素（この例では「SQL Server」）を取得できます。
• 範囲外のインデックスに注意：存在しないインデックスを指定した場合、そのフィールドは出力結果に含まれません。

このように、aggregateと$arrayElemAtを活用すれば、MongoDBの配列データから柔軟に目的の要素を抽出できます。集計処理やAPIレスポンスの整形など、さまざまな場面で役立つテクニックなので、ぜひ覚えておきましょう。