PostgreSQL jsonb_path_query_array() 函数使用指南

PostgreSQL jsonb_path_query_array() 函数在一个给定的 JSON 中根据指定的路径获取值,并将所有匹配的值作为一个数组返回。

jsonb_path_query_array() 语法

这是 PostgreSQL jsonb_path_query_array() 函数的语法:

jsonb_path_query_array(
    target JSONB
  , path JSONPATH
  [, vars JSONB
  [, silent BOOLEAN]]
) -> JSONB

参数

target
必需的。 要检查的 JSONB 值。
path
必需的。 要检查的 JSON 路径,它是 JSONPATH 类型的。
vars
可选的。 路径中要用到的变量值。
silent
可选的。 如果提供了此参数,并且为 true,该函数会像 @?@@ 操作符一样抑制相同的错误。

返回值

PostgreSQL jsonb_path_query_array() 函数返回一个 JSON 数组,它包含了在指定的 JSON 值中所有与指定的路径匹配的值。

如果任意一个参数是 NULL,jsonb_path_query_array() 函数将返回 NULL。

jsonb_path_query_array() 示例

JSON 数组

下面的示例展示了如何使用 PostgreSQL jsonb_path_query_array() 函数从一个 JSON 数组中根据指定的路径获取值。

SELECT jsonb_path_query_array('[1, 2, 3]', '$[*] ? (@ > 1)');
 jsonb_path_query_array
------------------------
 [2, 3]

我们可以在 JSON 路径中使用变量,如下:

SELECT jsonb_path_query_array(
    '[1, 2, 3, 4]',
    '$[*] ? (@ >= $min && @ <= $max)',
    '{"min": 2, "max": 3}'
);
 jsonb_path_query_array
------------------------
 [2, 3]

这里,我们在 JSON 路径 $[*] ? (@ >= $min && @ <= $max) 中使用了两个变量 minmax,并且我们在参数 var 中为变量提供了值 {"min": 2, "max": 3},这样,JSON 路径变成了 $[*] ? (@ >= 2 && @ <= 3)。也就是说,该函数用来返回数组 [1, 2, 3, 4] 中的大于等 2 并且小于等于 3 的所有的值。

JSON 对象

下面的示例展示了如何使用 PostgreSQL jsonb_path_query_array() 函数从一个 JSON 对象中根据指定的路径获取值。

SELECT jsonb_path_query_array(
    '{"x": 1, "y": 2, "z": 3}',
    '$.* ? (@ >= 2)'
);
 jsonb_path_query_array
------------------------
 [2, 3]

这里, JSON 路径 $.* ? (@ >= 2) 表示在 JSON 对象 {"x": 1, "y": 2, "z": 3} 中的顶层成员的值中所有大于 2 的值。