bag_set_key()

적용 대상: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

bag_set_key()는 속성 모음, 키 및 값을 받 dynamic 습니다. 함수는 모음의 지정된 키를 지정된 값으로 설정합니다. 키가 이미 있는 경우 함수는 기존 값을 재정의합니다.

구문

bag_set_key(모음,키,값)

구문 규칙에 대해 자세히 알아봅니다.

매개 변수

이름	Type	필수	설명
가방	dynamic	✔️	수정할 속성 모음입니다.
key	string	✔️	설정할 키입니다. JSON 경로(JSONPath 표기법을 사용하여 중첩된 수준에서 키를 지정할 수 있습니다) 또는 루트 수준 키의 키 이름입니다. 배열 인덱싱 또는 루트 JSON 경로는 지원되지 않습니다.
value	스칼라 데이터 형식	✔️	키가 설정된 값입니다.

반품

dynamic 지정된 키-값 쌍이 있는 속성 모음을 반환합니다. 입력 모음이 속성 모음이 아니면 값이 null 반환됩니다.

참고 항목

s를 빈 가방으로 처리 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	result
{ "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	result
{ "key1": 123, "key2": { "prop1": 123, "prop2": "xyz" } }	{ "key1": 123, "key2": { "prop1": "abc", "prop2": "xyz" } }
{ "key1": 123 }	{ "key1": 123, "key2": { "prop1": "abc" } }