$

  • Berlaku untuk: ✅ Azure DocumentDB

Operator $ posisi mengidentifikasi elemen dalam array untuk diperbarui tanpa secara eksplisit menentukan posisi elemen dalam array. Operator $ bertindak sebagai tempat penampung untuk elemen pertama yang cocok dengan kondisi kueri, dan bidang array harus muncul sebagai bagian dari dokumen kueri.

Syntax

db.collection.updateOne(
  { <array>: <value> },
  { <update operator>: { "<array>.$": <value> } }
)

Parameter-parameternya

Pengaturan Description
array Bidang array yang berisi elemen yang akan diperbarui. Harus menjadi bagian dari kondisi kueri.
value Nilai yang digunakan untuk mencocokkan elemen array dalam kondisi kueri.
update operator Operator pembaruan yang akan diterapkan (misalnya, , $set, $inc$unset).

Examples

Pertimbangkan dokumen sampel ini dari koleksi toko.

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

Contoh 1: Memproyeksikan elemen pertama dari array, yang cocok dengan kondisi

Kueri ini mengembalikan elemen pertama dalam salesByCategory array, untuk DJ peralatan dengan totalSales lebih besar dari 35000.

db.stores.find({
    "sales.salesByCategory": {
        $elemMatch: {
            categoryName: {
                $regex: "^DJ"
            }
        }
    },
    "sales.salesByCategory.totalSales": {
        $gt: 35000
    }
}, {
    "sales.salesByCategory.$": 1
}).limit(2)

Dua hasil pertama yang dikembalikan oleh kueri ini adalah:

[
  {
    "_id": "d3c9df51-41bd-4b4e-a26b-b038d9cf8b45",
    "sales": {
      "salesByCategory": [
        {
          "categoryName": "DJ Speakers",
          "totalSales": 36972
        }
      ]
    }
  },
  {
    "_id": "7954bd5c-9ac2-4c10-bb7a-2b79bd0963c5",
    "sales": {
      "salesByCategory": [
        {
          "categoryName": "DJ Headphones",
          "totalSales": 35911
        }
      ]
    }
  }
]

Contoh 2: Memperbarui persentase diskon untuk kategori tertentu

Kueri ini memperbarui persentase diskon untuk kategori "Meja" dalam acara promosi pertama yang cocok.

db.stores.updateOne(
  { 
    _id: "905d1939-e03a-413e-a9c4-221f74055aac",
    "promotionEvents.discounts.categoryName": "Desks"
  },
  {
    $set: { "promotionEvents.$.discounts.$[elem].discountPercentage": 25 }
  },
  {
    arrayFilters: [{ "elem.categoryName": "Desks" }]
  }
)

Contoh 3: Memperbarui total kategori penjualan

Kueri ini memperbarui total penjualan untuk kategori tertentu menggunakan $ (positional operator).

db.stores.updateOne(
  { 
    _id: "905d1939-e03a-413e-a9c4-221f74055aac",
    "sales.salesByCategory.categoryName": "Desk Lamps"
  },
  {
    $inc: { "sales.salesByCategory.$.totalSales": 1000 }
  }
)
  • Last updated on