コンテンツへスキップ

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で値を変換するか、型が合わない項目を除外してください。

OneClick Proについて

OneClick Proは、日々の作業に役立つ150以上のウェブツールを集めた無料コレクションです。画像や単位の変換、コードの整形と検証、ドメインやSEOの確認、テキスト、日付、数値の処理などに利用できます。すべてのツールは登録やサブスクリプションなしで使えます。入力した内容は結果の計算にのみ使用され、保存されることはありません。単発の作業に使える便利なツールボックスとして、または毎日使うツールをブックマークしてご活用ください。