$[]

DocumentDB'deki $[] işleci, belirtilen koşulla eşleşen bir dizideki tüm öğeleri güncelleştirmek için kullanılır. Bu işleç, konumlarını belirtmeden dizideki birden çok öğe üzerinde güncelleştirmeler gerçekleştirmenizi sağlar. Bir dizideki tüm öğelere aynı güncelleştirmeyi uygulamanız gerektiğinde özellikle yararlıdır.

Sözdizimi

db.collection.update(
   <query>,
   {
     $set: {
       <arrayField>.$[]: <value>
     }
   }
)

Parametreler

Örnekler

Stores koleksiyonundaki bu örnek belgeyi göz önünde bulundurun.

{
    "_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4",
    "name": "First Up Consultants | Beverage Shop - Satterfieldmouth",
    "location": {
        "lat": -89.2384,
        "lon": -46.4012
    },
    "staff": {
        "totalStaff": {
            "fullTime": 8,
            "partTime": 20
        }
    },
    "sales": {
        "totalSales": 75670,
        "salesByCategory": [
            {
                "categoryName": "Wine Accessories",
                "totalSales": 34440
            },
            {
                "categoryName": "Bitters",
                "totalSales": 39496
            },
            {
                "categoryName": "Rum",
                "totalSales": 1734
            }
        ]
    },
    "promotionEvents": [
        {
            "eventName": "Unbeatable Bargain Bash",
            "promotionalDates": {
                "startDate": {
                    "Year": 2024,
                    "Month": 6,
                    "Day": 23
                },
                "endDate": {
                    "Year": 2024,
                    "Month": 7,
                    "Day": 2
                }
            },
            "discounts": [
                {
                    "categoryName": "Whiskey",
                    "discountPercentage": 7
                },
                {
                    "categoryName": "Bitters",
                    "discountPercentage": 15
                },
                {
                    "categoryName": "Brandy",
                    "discountPercentage": 8
                },
                {
                    "categoryName": "Sports Drinks",
                    "discountPercentage": 22
                },
                {
                    "categoryName": "Vodka",
                    "discountPercentage": 19
                }
            ]
        },
        {
            "eventName": "Steal of a Deal Days",
            "promotionalDates": {
                "startDate": {
                    "Year": 2024,
                    "Month": 9,
                    "Day": 21
                },
                "endDate": {
                    "Year": 2024,
                    "Month": 9,
                    "Day": 29
                }
            },
            "discounts": [
                {
                    "categoryName": "Organic Wine",
                    "discountPercentage": 19
                },
                {
                    "categoryName": "White Wine",
                    "discountPercentage": 20
                },
                {
                    "categoryName": "Sparkling Wine",
                    "discountPercentage": 19
                },
                {
                    "categoryName": "Whiskey",
                    "discountPercentage": 17
                },
                {
                    "categoryName": "Vodka",
                    "discountPercentage": 23
                }
            ]
        }
    ]
}

Örnek 1: İndirim Yüzdelerini Güncelleştirme

Bu sorgu, her yükseltme olayının içindeki indirim dizisindeki tüm öğeleri güncelleştirir.

db.stores.updateOne(
  { _id: "905d1939-e03a-413e-a9c4-221f74055aac" },
  {
    $inc: {
      "promotionEvents.$[].discounts.$[].discountPercentage": 5
    }
  }
)

Örnek 2: Satışları Kategoriye Göre Güncelleştirme

Bu sorgu, $[] işlecini kullanarak tüm kategorilerin toplam satışlarını 10% artırır.

db.stores.update(
  { _id: "905d1939-e03a-413e-a9c4-221f74055aac" },
  {
    $mul: {
      "sales.salesByCategory.$[].totalSales": 1.10
    }
  }
)