pgjq

在Postgres中使用jq查询JSON

概览

扩展包名版本分类许可证语言
pgjq0.1.0UTILMITC
ID扩展名BinLibLoadCreateTrustReloc模式
4150pgjq-
相关扩展pgjwt pg_protobuf jsquery sparql gzip bzip zstd http

build with jq-devel

版本

类型仓库版本PG 大版本包名依赖
EXTPIGSTY0.1.01817161514pgjq-
RPMPIGSTY0.1.01817161514pgjq_$v-
DEBPIGSTY0.1.01817161514postgresql-$v-pgjq-
OS / PGPG18PG17PG16PG15PG14
el8.x86_64
el8.aarch64
el9.x86_64
el9.aarch64
el10.x86_64
el10.aarch64
d12.x86_64
d12.aarch64
d13.x86_64
d13.aarch64
u22.x86_64
u22.aarch64
PIGSTY 0.1.0
PIGSTY 0.1.0
PIGSTY 0.1.0
PIGSTY 0.1.0
PIGSTY 0.1.0
u24.x86_64
u24.aarch64
PIGSTY 0.1.0
PIGSTY 0.1.0
PIGSTY 0.1.0
PIGSTY 0.1.0
PIGSTY 0.1.0

构建

您可以使用 pig build 命令构建 pgjq 扩展的 RPM / DEB 包:

pig build pkg pgjq         # 构建 RPM / DEB 包

安装

您可以直接安装 pgjq 扩展包的预置二进制包,首先确保 PGDGPIGSTY 仓库已经添加并启用:

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展:

pig install pgjq;          # 当前活跃 PG 版本安装
pig ext install -y pgjq -v 18  # PG 18
pig ext install -y pgjq -v 17  # PG 17
pig ext install -y pgjq -v 16  # PG 16
pig ext install -y pgjq -v 15  # PG 15
pig ext install -y pgjq -v 14  # PG 14
dnf install -y pgjq_18       # PG 18
dnf install -y pgjq_17       # PG 17
dnf install -y pgjq_16       # PG 16
dnf install -y pgjq_15       # PG 15
dnf install -y pgjq_14       # PG 14
apt install -y postgresql-18-pgjq   # PG 18
apt install -y postgresql-17-pgjq   # PG 17
apt install -y postgresql-16-pgjq   # PG 16
apt install -y postgresql-15-pgjq   # PG 15
apt install -y postgresql-14-pgjq   # PG 14

创建扩展

CREATE EXTENSION pgjq;

用法

pgjq: 在 PostgreSQL 中使用 jq JSON 处理语言

提供 jqprog 数据类型和 jq() 函数,用于对 jsonb 对象执行 jq 程序。

基本过滤

SELECT jq('[{"bar": "baz", "balance": 7.77}]'::jsonb, '.[0].bar');
-- "baz"

使用 @@ 运算符

SELECT '[{"bar": "baz"}]' @@ '.[0].bar'::jqprog;
-- "baz"

复杂程序

SELECT jq('[true,false,[5,true,[true,[false]],false]]',
          '(..|select(type=="boolean")) |= if . then 1 else 0 end');
-- [1, 0, [5, 1, [1, [0]], 0]]

SELECT jq('[1,5,3,0,7]', '(.[] | select(. >= 2)) |= empty');
-- [1, 0]

传递参数

jsonb 对象传递动态参数,通过 $var 引用:

SELECT jq(
    '{"jobs": [{"id": 9, "ok": true}, {"id": 100, "ok": false}]}'::jsonb,
    '.jobs[] | select(.ok == $ok and .id == 100) | .',
    '{"ok": false}'
);

与 jsonpath 链式使用

SELECT jq('[{"cust":"baz","active":true,"trans":{"balance":100}}]',
          '(.[] | select(.active == true))') - '{trans}' @> '{"cust": "baz"}';
-- t

处理文件

SELECT jq(pg_read_file('/path/to/data.json'), '.[]');

最后修改 2026-03-14: update extension metadata (953cbd0)