Testador JMESPath
Teste uma expressão JMESPath em JSON e veja o resultado como JSON formatado. Escreva expressões como locations[?state == 'WA'].name | sort(@) para filtrar, projetar e remodelar dados. JMESPath é a linguagem de consulta usada pela opção --query do AWS CLI e pelo CLI do Azure, então esta é uma maneira rápida de acertar a consulta.
Perguntas frequentes
O que é JMESPath?
JMESPath é uma linguagem de consulta para JSON com uma especificação formal. Ela seleciona valores com caminhos como a.b, filtra arrays com [?condition], projeta listas com [*] e transforma dados com funções como sort_by, length e join.
Onde o JMESPath é usado?
O AWS CLI usa essa linguagem na opção --query, o CLI do Azure também a usa com --query, e o Ansible a oferece por meio do filtro json_query. Teste uma expressão aqui e depois cole-a no seu comando.
Qual é o resultado quando nada corresponde?
O JMESPath retorna null quando um caminho não existe e um array vazio quando nenhum item passa pelo filtro. A ferramenta exibe exatamente esse valor; portanto, null no resultado significa que a expressão não encontrou nada.
Como escrevo um literal de string em um filtro?
Use aspas simples para strings brutas, por exemplo [?name == 'web']. Os valores entre crases são literais JSON, como `10` ou `true`. Use aspas duplas para identificadores com caracteres especiais, como "first-name".
Quais funções estão disponíveis?
Todas as funções da especificação JMESPath, incluindo abs, avg, contains, ends_with, join, keys, length, map, max_by, merge, min_by, not_null, reverse, sort, sort_by, starts_with, sum, to_array, to_number, to_string, type e values.
Por que recebo um erro sobre tipos?
As funções JMESPath verificam os tipos dos argumentos. Por exemplo, abs aplicado a uma string falha com uma mensagem que indica o tipo esperado. Converta os valores primeiro com to_number ou to_string, ou filtre os itens que têm o tipo errado.