Partilhar via

parse_json()

  • Artigo

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Interpreta um string como um valor JSON e retorna o valor como dynamic. Se possível, o valor é convertido em tipos de dados relevantes. Para uma análise rigorosa sem conversão de tipo de dados, use funções extract() ou extract_json().

É melhor usar a função parse_json() sobre a função extract_json() quando você precisar extrair mais de um elemento de um objeto composto JSON. Use dynamic() sempre que possível.

Aliases preteridos: parsejson(), toobject(), todynamic()

Sintaxe

parse_json( json)

Saiba mais sobre convenções de sintaxe.

Parâmetros

Designação Tipo Necessário Descrição
json string ✔️ A cadeia de caracteres na forma de um valor formatado em JSON ou um dinâmico pacote de propriedades para analisar como JSON.

Devoluções

Um objeto do tipo dynamic que é determinado pelo valor de json:

  • Se json for do tipo dynamic, seu valor será usado as-is.
  • Se json for do tipo stringe for uma cadeia de caracteres JSON formatada corretamente, a cadeia de caracteres será analisada e o valor produzido será retornado.
  • Se json for do tipo string, mas não for uma cadeia de caracteres JSON formatada corretamente, o valor retornado será um objeto do tipo dynamic que contém o valor string original.

Exemplo

No exemplo a seguir, quando context_custom_metrics é um string que se parece com isto:

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

Em seguida, a consulta a seguir recupera o valor do slot de duration no objeto e, a partir disso, recupera dois slots, duration.value e duration.min (118.0 e 110.0, respectivamente).

datatable(context_custom_metrics:string)
[
    '{"duration":{"value":118.0,"count":5.0,"min":100.0,"max":150.0,"stdDev":0.0,"sampledValue":118.0,"sum":118.0}}'
]
| extend d = parse_json(context_custom_metrics)
| extend duration_value = d.duration.value, duration_min = d.duration.min

Notas

É comum ter uma cadeia de caracteres JSON descrevendo um pacote de propriedades no qual um dos "slots" é outra cadeia de caracteres JSON.

Por exemplo:

let d='{"a":123, "b":"{\\"c\\":456}"}';
print d

Nesses casos, não só é necessário invocar parse_json duas vezes, mas também certificar-se de que, na segunda chamada, tostring é usado. Caso contrário, a segunda chamada para parse_json apenas passará a entrada para o as-isde saída, porque seu tipo declarado é dynamic.

let d='{"a":123, "b":"{\\"c\\":456}"}';
print d_b_c=parse_json(tostring(parse_json(d).b)).c

Conteúdo relacionado