MongoDBで配列の最初の要素のプロパティを取得する方法｜$slice演算子の使い方

MongoDBで配列の最初の要素のプロパティを取得する方法

MongoDBでは、$slice演算子を使用することで、配列の先頭要素だけを簡単に取り出すことができます。本記事では、サンプルコレクションの作成から、find()メソッドと$slice演算子を組み合わせて配列の最初の要素のプロパティを取得するまでの手順を、具体的な実行例とともにわかりやすく解説します。

1. ドキュメントを含むコレクションを作成する

まず、insertOne()メソッドを使ってサンプルデータを登録しましょう。以下の例では、顧客情報を格納する「Details」という配列フィールドを持つドキュメントを作成しています。

> db.firstElementOfArray.insertOne(
...    {
...       _id: 100,
...       "Details": [
...          {
...              "CustomerName": "John",
...              "CustomerCountryName":"US"
...          }
...       ]
...    }
... );
{ "acknowledged" : true, "insertedId" : 100 }

続けて、配列に複数の要素を持つ2つ目のドキュメントも追加します。

> db.firstElementOfArray.insertOne(
...    {
...       _id: 101,
...       "Details": [
...          {
...              "CustomerName": "Carol",
...              "CustomerCountryName":"UK"
...          },
...          {
...              "CustomerName": "David",
...              "CustomerCountryName":"AUS"
...          }
...       ]
...    }
... );
{ "acknowledged" : true, "insertedId" : 101 }

2. find()メソッドで登録済みドキュメントを確認する

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

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

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

{
    "_id" : 100,
    "Details" : [
       {
           "CustomerName" : "John",
           "CustomerCountryName" : "US"
       }
    ]
}
{
    "_id" : 101,
    "Details" : [
       {
           "CustomerName" : "Carol",
           "CustomerCountryName" : "UK"
       },
       {
           "CustomerName" : "David",
           "CustomerCountryName" : "AUS"
       }
    ]
}

3. $slice演算子で配列の最初の要素のプロパティを取得する

ここが本題です。$slice演算子に1を指定すると、配列の先頭から1つの要素のみを返します。さらに「Details.CustomerName」に1を指定することで、CustomerNameフィールドだけを投影（プロジェクション）できます。

> db.firstElementOfArray.find({},{'Details':{$slice:1},'Details.CustomerName':1}).pretty();

実行結果は以下の通りです。各ドキュメントについて、配列の最初の要素に含まれるCustomerNameだけが取得できていることが確認できます。

{ "_id" : 100, "Details" : [ { "CustomerName" : "John" } ] }
{ "_id" : 101, "Details" : [ { "CustomerName" : "Carol" } ] }

まとめ

$slice演算子は、MongoDBで配列の一部だけを取得したい場合にとても便利な機能です。値に「1」を指定すれば先頭要素、「-1」を指定すれば末尾要素を取得できます。また、プロジェクションと組み合わせれば、必要なフィールドだけを効率よく取り出せるため、大量のデータを扱うアプリケーションではネットワーク転送量の削減にも役立ちます。ぜひ日々の開発で活用してみてください。