$map

L'operatore $map viene usato per applicare un'espressione a ogni elemento di una matrice e restituire una matrice con i risultati applicati. Questo operatore è utile per trasformare matrici all'interno di documenti, ad esempio la modifica di ogni elemento o l'estrazione di campi specifici.

Sintassi

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

Parametri

Parametro	Description
input	Matrice elaborata dall'espressione.
as	Nome della variabile per ogni elemento nella matrice.
in	Espressione da applicare a ogni elemento.

Esempi

Si consideri questo documento di esempio dalla raccolta negozi.

{
    "_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"
    ]
}

Esempio 1: Estrazione dei nomi di categoria

Questa query filtra la stores raccolta per _id, quindi proietta un nuovo campo categoryNames in cui ogni elemento della matrice salesByCategory ha un totaleSales aumentato di 500 usando l'operatore $map.

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

Questa query restituisce il risultato seguente.

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

Contenuti correlati

• Esaminare le opzioni per la migrazione da MongoDB ad Azure DocumentDB.
• Altre informazioni sulla compatibilità delle funzionalità con MongoDB.