$map

$map演算子は、配列内の各要素に式を適用し、結果が適用された配列を返すために使用されます。 この演算子は、各要素の変更や特定のフィールドの抽出など、ドキュメント内の配列を変換する場合に便利です。

構文

{
  $map: {
    input: <array>,
    as: <variable>,
    in: <expression>
  }
}

パラメーター

パラメーター	Description
input	式によって処理される配列。
as	配列内の各要素の変数名。
in	各要素に適用する式。

例示

stores コレクションのこのサンプル ドキュメントについて考えてみましょう。

{
    "_id": "988d2dd1-2faa-4072-b420-b91b95cbfd60",
    "name": "Lakeshore Retail",
    "location": {
        "lat": -51.3041,
        "lon": -166.0838
    },
    "staff": {
        "totalStaff": {
            "fullTime": 5,
            "partTime": 20
        }
    },
    "sales": {
        "totalSales": 266491,
        "salesByCategory": [
            {
                "categoryName": "Towel Racks",
                "totalSales": 13237
            },
            {
                "categoryName": "Washcloths",
                "totalSales": 44315
            },
            {
                "categoryName": "Face Towels",
                "totalSales": 42095
            },
            {
                "categoryName": "Toothbrush Holders",
                "totalSales": 47912
            },
            {
                "categoryName": "Hybrid Mattresses",
                "totalSales": 48660
            },
            {
                "categoryName": "Napkins",
                "totalSales": 31439
            },
            {
                "categoryName": "Pillow Cases",
                "totalSales": 38833
            }
        ]
    },
    "tag": [
        "#ShopLocal",
        "#FashionStore",
        "#SeasonalSale",
        "#FreeShipping",
        "#MembershipDeals"
    ]
}

例 1: カテゴリ名の抽出

このクエリでは、storesの_id コレクションをフィルター処理し、salesByCategory 配列内の各要素の totalSales が $map 演算子を使用して 500 増加する新しいフィールドcategoryNamesを投影します。

db.stores.aggregate([{
        $match: {
            _id: "988d2dd1-2faa-4072-b420-b91b95cbfd60"
        }
    },
    {
        $project: {
            categoryNames: {
                $map: {
                    input: "$sales.salesByCategory.totalSales",
                    as: "category",
                    in: {
                        $add: ["$$category", 500]
                    }
                }
            }
        }
    }
])

このクエリは、次の結果を返します。

[
  {
      "_id": "988d2dd1-2faa-4072-b420-b91b95cbfd60",
      "categoryNames": [
          13737,
          44815,
          42595,
          48412,
          49160,
          31939,
          39333
      ]
  }
]

関連コンテンツ

• MongoDB から Azure DocumentDB に移行するためのオプションを確認します。
• MongoDB との機能の互換性について詳しくは、こちらをご覧ください。