Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
bag_set_key() empfängt einen dynamic Eigenschaftenbehälter, einen Schlüssel und einen Wert. Die Funktion legt den angegebenen Schlüssel im Beutel auf den angegebenen Wert fest. Die Funktion setzt alle vorhandenen Werte außer Kraft, falls der Schlüssel bereits vorhanden ist.
Syntax
bag_set_key(
Wert des Taschenschlüssels,,)
Erfahren Sie mehr über Syntaxkonventionen.
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| Tasche | dynamic |
✔️ | Der zu ändernde Eigenschaftenbehälter. |
| -Taste | string |
✔️ | Der festzulegende Schlüssel. Entweder ein JSON-Pfad (Sie können einen Schlüssel auf den geschachtelten Ebenen mithilfe der JSONPath-Notation ) oder den Schlüsselnamen für einen Stammschlüssel angeben. Arrayindizierungs- oder JSON-Stammpfade werden nicht unterstützt. |
| Wert | beliebiger skalarer Datentyp | ✔️ | Der Wert, auf den der Schlüssel festgelegt ist. |
Gibt zurück
Gibt einen dynamic Eigenschaftenbehälter mit angegebenen Schlüsselwertpaaren zurück. Wenn der Eingabebehälter kein Eigenschaftenbehälter ist, wird ein null Wert zurückgegeben.
Hinweis
Um s als leere Taschen zu behandeln null, verwenden Sie coalesce(x, dynamic({})).
Beispiele
Im folgenden Beispiel wird das Festlegen eines Schlüssels auf Stammebene in einem Eigenschaftenbehälter veranschaulicht.
datatable(input: dynamic) [
dynamic({'key1': 1, 'key2': 2}),
dynamic({'key1': 1, 'key3': 'abc'}),
]
| extend result = bag_set_key(input, 'key3', 3)
| Eingabe | Ergebnis |
|---|---|
| { "key1": 1, "key2": 2 } |
{ "key1": 1, "key2": 2, "key3": 3 } |
| { "key1": 1, "key3": "abc" } |
{ "key1": 1, "key3": 3 } |
Im folgenden Beispiel wird das Festlegen eines JSONPath-Schlüssels in einem Eigenschaftenbehälter veranschaulicht.
datatable(input: dynamic)[
dynamic({'key1': 123, 'key2': {'prop1': 123, 'prop2': 'xyz'}}),
dynamic({'key1': 123})
]
| extend result = bag_set_key(input, '$.key2.prop1', 'abc')
| Eingabe | Ergebnis |
|---|---|
| { "key1": 123, "key2": { "prop1": 123, "prop2": "xyz" } } |
{ "key1": 123, "key2": { "prop1": "abc", "prop2": "xyz" } } |
| { "key1": 123 } |
{ "key1": 123, "key2": { "prop1": "abc" } } |