Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft 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()eextractjson()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 |