JMESPathテスター
JSONに対してJMESPath式をテストし、整形されたJSONとして結果を確認できます。locations[?state == 'WA'].name | sort(@)のような式を書いて、データの絞り込み、射影、再構成を行えます。JMESPathはAWSCLIの--queryオプションやAzure CLIで使われるクエリ言語なので、こうしたクエリを手早く正しく作成できます。
よくある質問
JMESPathとは何ですか?
JMESPathは、正式な仕様を持つJSON用のクエリ言語です。a.bのようなパスで値を選択し、[?condition]で配列を絞り込み、[*]でリストを射影します。また、sort_by、length、joinなどの関数でデータを変換できます。
JMESPathはどこで使われていますか?
AWSCLIでは--queryオプションに、Azure CLIでも同様に--queryに使われています。また、Ansibleではjson_queryフィルターから利用できます。ここで式をテストしてから、コマンドに貼り付けてください。
一致するものがない場合、結果はどうなりますか?
パスが存在しない場合、JMESPathはnullを返し、フィルターで項目が残らない場合は空の配列を返します。このツールはその値をそのまま出力するため、結果がnullなら式に一致するものがなかったことを意味します。
フィルターに文字列リテラルを書くにはどうすればよいですか?
raw文字列にはシングルクォートを使います(例: [?name == 'web'])。バッククォート内の値はJSONリテラルです(例: `10`や`true`)。"first-name"のような特殊文字を含む識別子にはダブルクォートを使います。
どの関数を利用できますか?
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仕様で定義されたすべての関数を利用できます。
型に関するエラーが出るのはなぜですか?
JMESPathの関数は引数の型をチェックします。たとえば文字列にabsを適用すると、期待される型を示すエラーが発生します。まずto_numberまたはto_stringで値を変換するか、型が合わない項目を除外してください。