bag_set_key()

  • [アーティクル]

bag_set_key() は、プロパティ バッグ、キー、および値を受け取ります dynamic 。 関数は、バッグ内の指定されたキーを指定された値に設定します。 この関数は、キーが既に存在する場合に備え、既存の値をオーバーライドします。

構文

bag_set_key(バッグ,キー,値)

構文規則について詳しく知る。

パラメーター

名前 型 必須 説明
bag dynamic ✔️ 変更するプロパティ バッグ。
key string ✔️ 設定するキー。 JSON パス ( JSONPath 表記を使用して入れ子になったレベルでキーを指定できます) またはルート レベル キーのキー名のいずれか。 配列インデックスまたはルート JSON パスはサポートされていません。
value 任意のスカラー データ型 ✔️ キーが設定される値。

戻り値

dynamic指定したキーと値のペアを持つプロパティ バッグを返します。 入力バッグがプロパティ バッグでない場合は、 null 値が返されます。

注意

を空のバッグとして扱 nullうには、 を使用します coalesce(x, dynamic({}))。

例

ルート レベルのキーを使用する

クエリを実行する

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

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 結果
{
"key1": 123,
"key2": {
"prop1": 123,
"prop2": "xyz"
}
}		 {
"key1": 123,
"key2": {
"prop1": "abc",
"prop2": "xyz"
}
}
{
"key1": 123
}		 {
"key1": 123,
"key2": {
"prop1": "abc"
}
}