Partilhar via


extract_json()

Aplica-se a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft Sentinel

Obtenha um elemento especificado de um texto JSON usando uma expressão de caminho.

Converta, opcionalmente, a cadeia de caracteres extraída para um tipo específico.

As extract_json() funções e extractjson() são equivalentes

Sintaxe

extract_json(jsonPath, dataTipo de fonte, )

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
Caminho json string ✔️ Um JSONPath que define um acessador no documento JSON.
fonte de dados string ✔️ Um documento JSON.
tipo string Um literal de tipo opcional. Se fornecido, o valor extraído é convertido para esse tipo. Por exemplo, typeof(long) converterá o valor extraído em um longarquivo .

Dicas de desempenho

  • Aplique cláusulas where antes de usar extract_json().
  • Considere a possibilidade de, em vez disso, usar uma correspondência da expressão regular com extract . Isso pode ser executado muito mais rápido, e será eficaz se JSON for produzido a partir de um modelo.
  • Use parse_json() se você precisa extrair mais de um valor de JSON.
  • Considere ter o JSON analisado na ingestão declarando o tipo da coluna como dinâmico.

Devoluções

Essa função executa uma consulta JSONPath em dataSource, que contém uma cadeia de caracteres JSON válida, convertendo opcionalmente esse valor em outro tipo, dependendo do terceiro argumento.

Exemplo

let json = '{"name": "John", "age": 30, "city": "New York"}';
print extract_json("$.name", json, typeof(string));

Saída

print_0
John