Partilhar via


extract_json()

Aplica-se a: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

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

Opcionalmente, converta a cadeia de caracteres extraída em um tipo específico.

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

Sintaxe

extract_json( jsonCaminho,fonte, de dadostipo)

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
jsonCaminho 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 este tipo. Por exemplo, typeof(long) converterá o valor extraído em um longarquivo .

Sugestões de desempenho

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

Devoluções

Esta 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.

Exemplos

O exemplo a seguir extrai o nome de uma cadeia de caracteres JSON e retorna uma tabela com o nome.

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

Realização

print_0
John