parse_xml()

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Interpretuje jako wartość XML, konwertuje string wartość na format JSON i zwraca wartość jako dynamic.

Składnia

parse_xml(xml)

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko	Type	Wymagania	opis
xml	string	✔️	Wartość ciągu sformatowanego w formacie XML do przeanalizowana.

Zwraca

Obiekt typu dynamiczny określany przez wartość xml lub null, jeśli format XML jest nieprawidłowy.

Konwersja jest wykonywana w następujący sposób:

XML	JSON	Access
<e/>	{ "e": null }	o.e
<e>text</e>	{ "e": "text" }	o.e
<e name="value" />	{ "e":{"@name": "value"} }	o.e["@name"]
<e name="value">text</e>	{ "e": { "@name": "value", "#text": "text" } }	o.e["@name"] o.e["#text"]
<e> <a>text</a> <b>text</b> </e>	{ "e": { "a": "text", "b": "text" } }	o.e.a.e.b
<e> <a>text</a> <a>text</a> </e>	{ "e": { "a": ["text", "text"] } }	o.e.a[0] o.a[1]
<e> text <a>text</a> </e>	{ "e": { "#text": "text", "a": "text" } }	1'o.e["#text"] o.a

Uwaga

• Maksymalna długość danych wejściowych string dla parse_xml parametru to 1 MB (1 048 576 bajtów). Interpretacja dłuższych ciągów spowoduje powstanie obiektu o wartości null.
• Zostaną przetłumaczone tylko węzły elementów, atrybuty i węzły tekstowe. Wszystkie inne elementy zostaną pominięte.

Przykład

W poniższym przykładzie, gdy context_custom_metrics element wygląda string następująco:

<?xml version="1.0" encoding="UTF-8"?>
<duration>
    <value>118.0</value>
    <count>5.0</count>
    <min>100.0</min>
    <max>150.0</max>
    <stdDev>0.0</stdDev>
    <sampledValue>118.0</sampledValue>
    <sum>118.0</sum>
</duration>

następnie następujący fragment CSL tłumaczy kod XML na następujący kod JSON:

{
    "duration": {
        "value": 118.0,
        "count": 5.0,
        "min": 100.0,
        "max": 150.0,
        "stdDev": 0.0,
        "sampledValue": 118.0,
        "sum": 118.0
    }
}

i pobiera wartość duration miejsca w obiekcie, a następnie pobiera dwa miejsca i duration.value duration.min (118.0 i 100.0, odpowiednio).

T
| extend d=parse_xml(context_custom_metrics) 
| extend duration_value=d.duration.value, duration_min=d["duration"]["min"]