Sdílet prostřednictvím

bag_set_key()

  • Článek

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

bag_set_key() obdrží tašku dynamic vlastností, klíč a hodnotu. Funkce nastaví daný klíč v sáčku na danou hodnotu. Funkce přepíše všechny existující hodnoty v případě, že klíč již existuje.

Syntaxe

bag_set_key(hodnota klíče,tašky,)

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název Type Požadováno Popis
pytel dynamic ✔️ Taška vlastností, která se má upravit.
key string ✔️ Klíč, který chcete nastavit. Buď cesta JSON (můžete zadat klíč na vnořených úrovních pomocí zápisu JSONPath ) nebo název klíče kořenové úrovně. Indexování polí nebo kořenové cesty JSON se nepodporují.
value libovolný skalární datový typ ✔️ Hodnota, na kterou je klíč nastaven.

Návraty

Vrátí tašku dynamic vlastností se zadanými páry klíč-hodnota. Pokud vstupní taška není taška vlastností, null vrátí se hodnota.

Poznámka:

Chcete-li zacházet nulljako s prázdnými taškami, použijte coalesce(x, dynamic({})).

Příklady

Použití klíče kořenové úrovně

datatable(input: dynamic) [
    dynamic({'key1': 1, 'key2': 2}), 
    dynamic({'key1': 1, 'key3': 'abc'}),
]
| extend result = bag_set_key(input, 'key3', 3)
input result
{
"key1": 1,
"key2": 2
}		 {
"key1": 1,
"key2": 2,
"key3": 3
}
{
"key1": 1,
"key3": "abc"
}		 {
"key1": 1,
"key3": 3
}

Použití klíče JSONPath

datatable(input: dynamic)[
    dynamic({'key1': 123, 'key2': {'prop1': 123, 'prop2': 'xyz'}}),
    dynamic({'key1': 123})
]
| extend result = bag_set_key(input, '$.key2.prop1', 'abc')
input result
{
"key1": 123,
"key2": {
"prop1": 123,
"prop2": "xyz"
}
}		 {
"key1": 123,
"key2": {
"prop1": "abc",
"prop2": "xyz"
}
}
{
"key1": 123
}		 {
"key1": 123,
"key2": {
"prop1": "abc"
}
}