JMESPath语言

JMESPath（JSON Matching Expression Path）

一种查询语言。

主要用于从JSON文档中检索和过滤数据。

通过写表达式提取和处理JSON数据，而无需编写复杂的代码。

功能：数据提取、过滤、转换、排序。

场景：处理API响应、数据分析、数据转换 etc。

数据提取：从复杂的JSON文档中提取所需的信息。例如，从包含多个嵌套对象和数组的JSON文档中提取特定属性。

数据过滤：基于特定条件过滤JSON数据。例如，从一个包含多个对象的数组中过滤出满足特定属性值条件的对象。

数据转换：将JSON数据转换为其他格式。例如，将一个包含多个属性的对象转换为一个只包含部分属性的新对象，或将一个数组转换为一个新的数组，其中的元素经过特定计算或操作。

数据排序：根据特定属性对JSON数据进行排序。

JMESPath — JMESPathhttps://jmespath.org/

本文主要以 JMESPath Tutorial and Examples 为操作示例，还有包括一些其他常用示例：

目录

一些常用调用方式

一些常用表达式

一些常用嵌套语句

---

一些常用调用方式

源	jmespath	结果	备注
{   "demo": "hello world" }	demo	"hello world"	str
{   "demo": 1 }	demo	1	int
{   "demo": ["1", "2"] }	demo / demo[*] / demo[:] / demo[]	["1","2" ]	array
{   "demo": {     "key": "value",     "k": "v",     "a": {"b": "c"}   } }	demo	{"key": "value","k": "v","a": {"b": "c"} }	object
{}	demo	null	null

元素获取

源	jmespath	结果	备注
{   "demo": {     "key": "value",     "k": "v",     "a": {"b": "c"}   } }	demo.key / demo."key"	"value"
同上	demo.a.b	"c"
同上	demo.[key, k]	[ "value","v" ]
同上	demo.{"k1": key, "k2": k} / demo.{k1: key, k2: k}	{"k1": "value","k2": "v" }
{"d":{}}	d	{}
{   "demo": [1, 2, 3] }	demo[0] / demo[:1]	1
{"d":[]}	d	[]
同上	demo[2:]	3	slice：[start:stop:step]或[start:stop]，step为负则倒取
同上	demo[3]	null
同上	demo[1:3]	[2, 3]	slice
同上	demo[::-1]	[3, 2, 1]	slice
同上	demo[::2]	[1,3]	slice

一些常用表达式

源	jmespath	结果	备注
{   "demo": [1, 2, 3] }	to_string(demo)	"[1,2,3]"	转字符串 to_string（打平显示使用）
同上	length(demo)	3	长度 length
同上	type(demo)	"array"
{   "demo": {     "key": "value",     "k": "v",     "a": {"b": "c"}   } }	to_string(demo)	"{\"key\":\"value\",\"k\":\"v\",\"a\":{\"b\":\"c\"}}"
同上	length(demo)	3
同上	type(demo)	"object"
{"a": "1.1"}	to_number(a)	1.1	to number转数字
{   "demo": [1, 2, 19] }	max(demo)	19	max最大值
同上	min(demo)	1	min最小值
同上	avg(demo)	7.333333333333333	avg平均数（显示长度控制在16位）
同上	sum(demo)	22	sum和
同上	hhh || demo[0]	1	||
同上	demo[1] || demo[2]	2
同上	demo[1] && demo[2]	19	&&
{   "a": [     {       "b1": "James",       "b2": "d",       "c": 30     },     {       "b1": "Jacob",       "b2": "e",       "c": 35     },     {       "b1": "Jayden",       "b2": "f",       "c": 25     }   ] }	a[?c > `18`]	[{"b1": "Jacob","b2": "e","c": 20},{"b1": "Jayden","b2": "f","c": 23} ]	条件选择 filter
同上	a[?c > `18`].{b1: b1, age: c}	[{"b1": "Jacob","age": 20},{"b1": "Jayden","age": 23} ]
同上	a[?c==`18`]	[{"b1": "James","b2": "d","c": 18} ]
同上	a[?c==`18`].{b1: b1, age: c}	[{"b1": "James","age": 18} ] ​​​​​​​
同上	a[?c==`20`].[b1, b2]	[["Jacob","e"] ]
同上	a[?c==`20`].[b1, b2] | [] / a[?c==`20`].[b1, b2] | [0]	["Jacob","e" ]	管道表达式。  | [] 或 | [0]的写法能消除嵌套下的外[]
同上	a | [0] / a | []	{"b1": "James","b2": "d","c": 18 }
同上	a | [1]	{"b1": "Jacob","b2": "e","c": 20 }
{"a":[{"b1":"詹姆斯","b2":"d","c":30},{"b1":"雅各布","b2":"e","c":35},{"b1":"杰登","b2":"f","c":25}]}	sort_by(a, &c)	[{"b1": "杰登","b2": "f","c": 25},{"b1": "詹姆斯","b2": "d","c": 30},{"b1": "雅各布","b2": "e","c": 35} ]	sort_by排序
同上	join(' ', [a[0].b1, a[1].b1, a[2].b1])	"詹姆斯 雅各布 杰登"	join字符串拼接
{   "a": [     "foo",     "foobar",     "barfoo",     "bar",     "barbaz",     "barfoobaz"   ] }	a[?contains(@, 'foo') == `true`]	["foo"，"foobar"，"barfoo"，barfoobaz]	字符匹配 contains与匿名@

一些常用嵌套语句

嵌套调用

源	jmespath	结果	备注
{"a": {     "c": [       {"d": [0, [1, 2]]}     ] }}	a.c[0].d[1][0]	1
{   "a": [     {       "b1": "James",       "b2": "d",       "c": 30     },     {       "b1": "Jacob",       "b2": "e",       "c": 35     },     {       "b1": "Jayden",       "b2": "f",       "c": 25     }   ] }	a[*].b1 / a[].b1 / a[:].b1	["James","Jacob","Jayden" ]
同上	a[*].[b1, b2]	[   ["James", "d"],   ["Jacob", "e"],   ["Jayden", "f"] ]
同上	a[*].[*]	[   [["James", "d", 30]],   [["Jacob", "e", 35]],   [["Jayden", "f", 25]] ]
同上	a[*].{b1: b1, "b2": `1`}	[{"b1": "James","b2": 1},{"b1": "Jacob","b2": 1},{"b1": "Jayden","b2": 1} ]
同上	a[::2].{b1: b1, "b2": `1`}	[{"b1": "James","b2": 1},{"b1": "Jayden","b2": 1} ]
{     "a": {         "a1": {             "b1": "James",             "b2": "d",             "c": 30         },         "a2": {             "b1": "Jacob",             "b2": "e",             "c": 35         },         "a3": {             "b1": "Jayden",             "b2": "f",             "c": 25         }     } }	a.*.c	[30,35,25 ]
同上	a.*.*	[   ["James", "d", 30],   ["Jacob", "e", 35],   ["Jayden", "f", 25] ]

​​​​​​​