$[Bezeichner]

  • Gilt für:: ✅ Azure DocumentDB

Der Arrayaktualisierungsoperator $[bezeichner] wird verwendet, um bestimmte Elemente in einem Array zu aktualisieren, das einer bestimmten Bedingung entspricht. Dieser Operator ist nützlich, wenn Sie mehrere Elemente innerhalb eines Arrays basierend auf bestimmten Kriterien aktualisieren müssen. Es ermöglicht detailliertere Aktualisierungen innerhalb von Dokumenten, wodurch es zu einem leistungsfähigen Tool für die Verwaltung komplexer Datenstrukturen wird.

Syntax

{
  <update operator>: {
    <array field>.$[<identifier>]: <value>
  }
},
{
  arrayFilters: [
    { <identifier>.<field>: <condition> }
  ]
}

Die Parameter

Parameter Description
<update operator> Der aktualisierungsoperator, der angewendet werden soll (z $set. B. , , $incusw.).
<array field> Das Feld, das das Array enthält, das aktualisiert werden soll.
<identifier> Ein Platzhalter, der zum Abgleichen bestimmter Elemente im Array verwendet wird arrayFilters .
<value> Der festzulegende oder aktualisierte Wert.
arrayFilters Ein Array von Filterbedingungen, um zu identifizieren, welche Elemente aktualisiert werden sollen.
<field> Das spezifische Feld innerhalb der zu überprüfenden Arrayelemente.
<condition> Die Bedingung, dass Arrayelemente erfüllt werden müssen, um aktualisiert zu werden.

Examples

Betrachten Sie dieses Beispieldokument aus der Stores-Sammlung.

{
    "_id": "905d1939-e03a-413e-a9c4-221f74055aac",
    "name": "Trey Research | Home Office Depot - Lake Freeda",
    "location": {
        "lat": -48.9752,
        "lon": -141.6816
    },
    "staff": {
        "employeeCount": {
            "fullTime": 12,
            "partTime": 19
        }
    },
    "sales": {
        "salesByCategory": [
            {
                "categoryName": "Desk Lamps",
                "totalSales": 37978
            }
        ],
        "revenue": 37978
    },
    "promotionEvents": [
        {
            "eventName": "Crazy Deal Days",
            "promotionalDates": {
                "startDate": {
                    "Year": 2023,
                    "Month": 9,
                    "Day": 27
                },
                "endDate": {
                    "Year": 2023,
                    "Month": 10,
                    "Day": 4
                }
            },
            "discounts": [
                {
                    "categoryName": "Desks",
                    "discountPercentage": 25
                },
                {
                    "categoryName": "Filing Cabinets",
                    "discountPercentage": 23
                }
            ]
        },
        {
            "eventName": "Incredible Markdown Mania",
            "promotionalDates": {
                "startDate": {
                    "Year": 2023,
                    "Month": 12,
                    "Day": 26
                },
                "endDate": {
                    "Year": 2024,
                    "Month": 1,
                    "Day": 2
                }
            },
            "discounts": [
                {
                    "categoryName": "Monitor Stands",
                    "discountPercentage": 20
                },
                {
                    "categoryName": "Desks",
                    "discountPercentage": 24
                }
            ]
        },
        {
            "eventName": "Major Deal Days",
            "promotionalDates": {
                "startDate": {
                    "Year": 2024,
                    "Month": 3,
                    "Day": 25
                },
                "endDate": {
                    "Year": 2024,
                    "Month": 4,
                    "Day": 2
                }
            },
            "discounts": [
                {
                    "categoryName": "Office Accessories",
                    "discountPercentage": 9
                },
                {
                    "categoryName": "Desks",
                    "discountPercentage": 13
                }
            ]
        },
        {
            "eventName": "Blowout Bonanza",
            "promotionalDates": {
                "startDate": {
                    "Year": 2024,
                    "Month": 6,
                    "Day": 23
                },
                "endDate": {
                    "Year": 2024,
                    "Month": 7,
                    "Day": 2
                }
            },
            "discounts": [
                {
                    "categoryName": "Office Chairs",
                    "discountPercentage": 24
                },
                {
                    "categoryName": "Desk Lamps",
                    "discountPercentage": 19
                }
            ]
        },
        {
            "eventName": "Super Saver Fiesta",
            "promotionalDates": {
                "startDate": {
                    "Year": 2024,
                    "Month": 9,
                    "Day": 21
                },
                "endDate": {
                    "Year": 2024,
                    "Month": 10,
                    "Day": 1
                }
            },
            "discounts": [
                {
                    "categoryName": "Desks",
                    "discountPercentage": 5
                },
                {
                    "categoryName": "Monitor Stands",
                    "discountPercentage": 10
                }
            ]
        }
    ],
    "company": "Trey Research",
    "city": "Lake Freeda",
    "storeOpeningDate": "2024-12-30T22:55:25.779Z",
    "lastUpdated": {
        "t": 1729983325,
        "i": 1
    }
}

Beispiel 1: Aktualisieren Sie den Rabattprozentsatz für die ausgewählte Kategorie im angegebenen Promotion-Ereignis.

Diese Abfrage aktualisiert den Rabattprozentsatz für die Kategorie "Schreibtischlampen", indem die spezifischen Elemente im Angebotsereignisarray geändert werden, wobei der Ereignisname "Blowout Bonanza" lautet.

db.stores.updateOne(
  {
    _id: "905d1939-e03a-413e-a9c4-221f74055aac",
    "promotionEvents.eventName": "Blowout Bonanza"
  },
  {
    $set: {
      "promotionEvents.$[event].discounts.$[discount].discountPercentage": 18
    }
  },
  {
    arrayFilters: [
      { "event.eventName": "Blowout Bonanza" },
      { "discount.categoryName": "Desk Lamps" }
    ]
  }
)
  • Last updated on