Тестер JMESPath
Проверьте выражение JMESPath для JSON и посмотрите результат в форматированном виде JSON. Введите выражение, например locations[?state == 'WA'].name | sort(@), чтобы фильтровать, проецировать и преобразовывать данные. JMESPath — язык запросов, используемый в параметре --query CLI AWS CLI и в Azure CLI. Это быстрый способ составить правильный запрос.
Часто задаваемые вопросы
Что такое JMESPath?
JMESPath — язык запросов к JSON с формальной спецификацией. Он выбирает значения по путям, например a.b, фильтрует массивы с помощью [?condition], проецирует списки с помощью [*] и преобразует данные функциями sort_by, length и join.
Где используется JMESPath?
AWS CLI использует его для параметра --query, Azure CLI также применяет его для --query, а Ansible предоставляет его в виде фильтра json_query. Проверьте выражение здесь, а затем вставьте его в команду.
Как выглядит результат, если ничего не найдено?
JMESPath возвращает null, если путь не существует, и пустой массив, если фильтр не оставил ни одного элемента. Инструмент выводит именно это значение, поэтому null в результате означает, что выражение ничего не нашло.
Как задать строковый литерал в фильтре?
Для строковых литералов используйте одинарные кавычки, например [?name == 'web']. Значения в обратных кавычках — это литералы JSON, например `10` или `true`. Двойные кавычки нужны для идентификаторов со специальными символами, например "first-name".
Какие функции доступны?
Все функции спецификации JMESPath, включая 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 и values.
Почему появляется ошибка о типах?
Функции JMESPath проверяют типы аргументов. Например, abs для строки выдаст ошибку с указанием ожидаемого типа. Сначала преобразуйте значения с помощью to_number или to_string либо отфильтруйте элементы неподходящего типа.