is_jsonb_valid

原生 JSONB 校验，支持 JSON Schema 草案 4 与 7

概览

扩展包名	版本	分类	许可证	语言
`is_jsonb_valid`	`0.1.4`	FEAT	MIT	C

ID	扩展名	Bin	Lib	Load	Create	Trust	Reloc	模式
2765	`is_jsonb_valid`	否	是	否	是	否	否	-

相关扩展	`pg_jsonschema` `jsonschema` `postgres-json-schema` `jsquery`

Remote $ref and format validation are unsupported; local $ref resolution is limited. Ships two libraries under one extension identity.

版本

类型	仓库	版本	PG 大版本	包名	依赖
EXT	PIGSTY	`0.1.4`	1817161514	`is_jsonb_valid`	-
RPM	PIGSTY	`0.1.4`	1817161514	`is_jsonb_valid_$v`	-
DEB	PIGSTY	`0.1.4`	1817161514	`postgresql-$v-is-jsonb-valid`	-

OS / PG	PG18	PG17	PG16	PG15	PG14
el8.x86_64	PIGSTY 0.1.4 el8.x86_64.pg18 : is_jsonb_valid_18 is_jsonb_valid_18-0.1.4-1PGSTY.el8.x86_64.rpm PIGSTY · 0.1.4 · 63.0KiB	PIGSTY 0.1.4 el8.x86_64.pg17 : is_jsonb_valid_17 is_jsonb_valid_17-0.1.4-1PGSTY.el8.x86_64.rpm PIGSTY · 0.1.4 · 62.9KiB	PIGSTY 0.1.4 el8.x86_64.pg16 : is_jsonb_valid_16 is_jsonb_valid_16-0.1.4-1PGSTY.el8.x86_64.rpm PIGSTY · 0.1.4 · 62.9KiB	PIGSTY 0.1.4 el8.x86_64.pg15 : is_jsonb_valid_15 is_jsonb_valid_15-0.1.4-1PGSTY.el8.x86_64.rpm PIGSTY · 0.1.4 · 62.9KiB	PIGSTY 0.1.4 el8.x86_64.pg14 : is_jsonb_valid_14 is_jsonb_valid_14-0.1.4-1PGSTY.el8.x86_64.rpm PIGSTY · 0.1.4 · 63.0KiB
el8.aarch64	PIGSTY 0.1.4 el8.aarch64.pg18 : is_jsonb_valid_18 is_jsonb_valid_18-0.1.4-1PGSTY.el8.aarch64.rpm PIGSTY · 0.1.4 · 62.4KiB	PIGSTY 0.1.4 el8.aarch64.pg17 : is_jsonb_valid_17 is_jsonb_valid_17-0.1.4-1PGSTY.el8.aarch64.rpm PIGSTY · 0.1.4 · 62.3KiB	PIGSTY 0.1.4 el8.aarch64.pg16 : is_jsonb_valid_16 is_jsonb_valid_16-0.1.4-1PGSTY.el8.aarch64.rpm PIGSTY · 0.1.4 · 62.3KiB	PIGSTY 0.1.4 el8.aarch64.pg15 : is_jsonb_valid_15 is_jsonb_valid_15-0.1.4-1PGSTY.el8.aarch64.rpm PIGSTY · 0.1.4 · 62.2KiB	PIGSTY 0.1.4 el8.aarch64.pg14 : is_jsonb_valid_14 is_jsonb_valid_14-0.1.4-1PGSTY.el8.aarch64.rpm PIGSTY · 0.1.4 · 62.4KiB
el9.x86_64	PIGSTY 0.1.4 el9.x86_64.pg18 : is_jsonb_valid_18 is_jsonb_valid_18-0.1.4-1PGSTY.el9.x86_64.rpm PIGSTY · 0.1.4 · 64.8KiB	PIGSTY 0.1.4 el9.x86_64.pg17 : is_jsonb_valid_17 is_jsonb_valid_17-0.1.4-1PGSTY.el9.x86_64.rpm PIGSTY · 0.1.4 · 64.6KiB	PIGSTY 0.1.4 el9.x86_64.pg16 : is_jsonb_valid_16 is_jsonb_valid_16-0.1.4-1PGSTY.el9.x86_64.rpm PIGSTY · 0.1.4 · 64.6KiB	PIGSTY 0.1.4 el9.x86_64.pg15 : is_jsonb_valid_15 is_jsonb_valid_15-0.1.4-1PGSTY.el9.x86_64.rpm PIGSTY · 0.1.4 · 64.7KiB	PIGSTY 0.1.4 el9.x86_64.pg14 : is_jsonb_valid_14 is_jsonb_valid_14-0.1.4-1PGSTY.el9.x86_64.rpm PIGSTY · 0.1.4 · 64.7KiB
el9.aarch64	PIGSTY 0.1.4 el9.aarch64.pg18 : is_jsonb_valid_18 is_jsonb_valid_18-0.1.4-1PGSTY.el9.aarch64.rpm PIGSTY · 0.1.4 · 64.2KiB	PIGSTY 0.1.4 el9.aarch64.pg17 : is_jsonb_valid_17 is_jsonb_valid_17-0.1.4-1PGSTY.el9.aarch64.rpm PIGSTY · 0.1.4 · 64.1KiB	PIGSTY 0.1.4 el9.aarch64.pg16 : is_jsonb_valid_16 is_jsonb_valid_16-0.1.4-1PGSTY.el9.aarch64.rpm PIGSTY · 0.1.4 · 64.1KiB	PIGSTY 0.1.4 el9.aarch64.pg15 : is_jsonb_valid_15 is_jsonb_valid_15-0.1.4-1PGSTY.el9.aarch64.rpm PIGSTY · 0.1.4 · 63.9KiB	PIGSTY 0.1.4 el9.aarch64.pg14 : is_jsonb_valid_14 is_jsonb_valid_14-0.1.4-1PGSTY.el9.aarch64.rpm PIGSTY · 0.1.4 · 64.1KiB
el10.x86_64	PIGSTY 0.1.4 el10.x86_64.pg18 : is_jsonb_valid_18 is_jsonb_valid_18-0.1.4-1PGSTY.el10.x86_64.rpm PIGSTY · 0.1.4 · 64.9KiB	PIGSTY 0.1.4 el10.x86_64.pg17 : is_jsonb_valid_17 is_jsonb_valid_17-0.1.4-1PGSTY.el10.x86_64.rpm PIGSTY · 0.1.4 · 64.9KiB	PIGSTY 0.1.4 el10.x86_64.pg16 : is_jsonb_valid_16 is_jsonb_valid_16-0.1.4-1PGSTY.el10.x86_64.rpm PIGSTY · 0.1.4 · 64.8KiB	PIGSTY 0.1.4 el10.x86_64.pg15 : is_jsonb_valid_15 is_jsonb_valid_15-0.1.4-1PGSTY.el10.x86_64.rpm PIGSTY · 0.1.4 · 64.8KiB	PIGSTY 0.1.4 el10.x86_64.pg14 : is_jsonb_valid_14 is_jsonb_valid_14-0.1.4-1PGSTY.el10.x86_64.rpm PIGSTY · 0.1.4 · 64.9KiB
el10.aarch64	PIGSTY 0.1.4 el10.aarch64.pg18 : is_jsonb_valid_18 is_jsonb_valid_18-0.1.4-1PGSTY.el10.aarch64.rpm PIGSTY · 0.1.4 · 64.2KiB	PIGSTY 0.1.4 el10.aarch64.pg17 : is_jsonb_valid_17 is_jsonb_valid_17-0.1.4-1PGSTY.el10.aarch64.rpm PIGSTY · 0.1.4 · 64.2KiB	PIGSTY 0.1.4 el10.aarch64.pg16 : is_jsonb_valid_16 is_jsonb_valid_16-0.1.4-1PGSTY.el10.aarch64.rpm PIGSTY · 0.1.4 · 64.2KiB	PIGSTY 0.1.4 el10.aarch64.pg15 : is_jsonb_valid_15 is_jsonb_valid_15-0.1.4-1PGSTY.el10.aarch64.rpm PIGSTY · 0.1.4 · 64.0KiB	PIGSTY 0.1.4 el10.aarch64.pg14 : is_jsonb_valid_14 is_jsonb_valid_14-0.1.4-1PGSTY.el10.aarch64.rpm PIGSTY · 0.1.4 · 64.2KiB
d12.x86_64	PIGSTY 0.1.4 d12.x86_64.pg18 : postgresql-18-is-jsonb-valid postgresql-18-is-jsonb-valid_0.1.4-1PGSTY~bookworm_amd64.deb PIGSTY · 0.1.4 · 51.2KiB	PIGSTY 0.1.4 d12.x86_64.pg17 : postgresql-17-is-jsonb-valid postgresql-17-is-jsonb-valid_0.1.4-1PGSTY~bookworm_amd64.deb PIGSTY · 0.1.4 · 51.2KiB	PIGSTY 0.1.4 d12.x86_64.pg16 : postgresql-16-is-jsonb-valid postgresql-16-is-jsonb-valid_0.1.4-1PGSTY~bookworm_amd64.deb PIGSTY · 0.1.4 · 51.1KiB	PIGSTY 0.1.4 d12.x86_64.pg15 : postgresql-15-is-jsonb-valid postgresql-15-is-jsonb-valid_0.1.4-1PGSTY~bookworm_amd64.deb PIGSTY · 0.1.4 · 51.0KiB	PIGSTY 0.1.4 d12.x86_64.pg14 : postgresql-14-is-jsonb-valid postgresql-14-is-jsonb-valid_0.1.4-1PGSTY~bookworm_amd64.deb PIGSTY · 0.1.4 · 52.8KiB
d12.aarch64	PIGSTY 0.1.4 d12.aarch64.pg18 : postgresql-18-is-jsonb-valid postgresql-18-is-jsonb-valid_0.1.4-1PGSTY~bookworm_arm64.deb PIGSTY · 0.1.4 · 49.6KiB	PIGSTY 0.1.4 d12.aarch64.pg17 : postgresql-17-is-jsonb-valid postgresql-17-is-jsonb-valid_0.1.4-1PGSTY~bookworm_arm64.deb PIGSTY · 0.1.4 · 49.5KiB	PIGSTY 0.1.4 d12.aarch64.pg16 : postgresql-16-is-jsonb-valid postgresql-16-is-jsonb-valid_0.1.4-1PGSTY~bookworm_arm64.deb PIGSTY · 0.1.4 · 49.6KiB	PIGSTY 0.1.4 d12.aarch64.pg15 : postgresql-15-is-jsonb-valid postgresql-15-is-jsonb-valid_0.1.4-1PGSTY~bookworm_arm64.deb PIGSTY · 0.1.4 · 49.6KiB	PIGSTY 0.1.4 d12.aarch64.pg14 : postgresql-14-is-jsonb-valid postgresql-14-is-jsonb-valid_0.1.4-1PGSTY~bookworm_arm64.deb PIGSTY · 0.1.4 · 51.4KiB
d13.x86_64	PIGSTY 0.1.4 d13.x86_64.pg18 : postgresql-18-is-jsonb-valid postgresql-18-is-jsonb-valid_0.1.4-1PGSTY~trixie_amd64.deb PIGSTY · 0.1.4 · 51.0KiB	PIGSTY 0.1.4 d13.x86_64.pg17 : postgresql-17-is-jsonb-valid postgresql-17-is-jsonb-valid_0.1.4-1PGSTY~trixie_amd64.deb PIGSTY · 0.1.4 · 51.1KiB	PIGSTY 0.1.4 d13.x86_64.pg16 : postgresql-16-is-jsonb-valid postgresql-16-is-jsonb-valid_0.1.4-1PGSTY~trixie_amd64.deb PIGSTY · 0.1.4 · 51.1KiB	PIGSTY 0.1.4 d13.x86_64.pg15 : postgresql-15-is-jsonb-valid postgresql-15-is-jsonb-valid_0.1.4-1PGSTY~trixie_amd64.deb PIGSTY · 0.1.4 · 50.9KiB	PIGSTY 0.1.4 d13.x86_64.pg14 : postgresql-14-is-jsonb-valid postgresql-14-is-jsonb-valid_0.1.4-1PGSTY~trixie_amd64.deb PIGSTY · 0.1.4 · 52.8KiB
d13.aarch64	PIGSTY 0.1.4 d13.aarch64.pg18 : postgresql-18-is-jsonb-valid postgresql-18-is-jsonb-valid_0.1.4-1PGSTY~trixie_arm64.deb PIGSTY · 0.1.4 · 49.8KiB	PIGSTY 0.1.4 d13.aarch64.pg17 : postgresql-17-is-jsonb-valid postgresql-17-is-jsonb-valid_0.1.4-1PGSTY~trixie_arm64.deb PIGSTY · 0.1.4 · 49.6KiB	PIGSTY 0.1.4 d13.aarch64.pg16 : postgresql-16-is-jsonb-valid postgresql-16-is-jsonb-valid_0.1.4-1PGSTY~trixie_arm64.deb PIGSTY · 0.1.4 · 49.7KiB	PIGSTY 0.1.4 d13.aarch64.pg15 : postgresql-15-is-jsonb-valid postgresql-15-is-jsonb-valid_0.1.4-1PGSTY~trixie_arm64.deb PIGSTY · 0.1.4 · 49.6KiB	PIGSTY 0.1.4 d13.aarch64.pg14 : postgresql-14-is-jsonb-valid postgresql-14-is-jsonb-valid_0.1.4-1PGSTY~trixie_arm64.deb PIGSTY · 0.1.4 · 51.4KiB
u22.x86_64	PIGSTY 0.1.4 u22.x86_64.pg18 : postgresql-18-is-jsonb-valid postgresql-18-is-jsonb-valid_0.1.4-1PGSTY~jammy_amd64.deb PIGSTY · 0.1.4 · 53.8KiB	PIGSTY 0.1.4 u22.x86_64.pg17 : postgresql-17-is-jsonb-valid postgresql-17-is-jsonb-valid_0.1.4-1PGSTY~jammy_amd64.deb PIGSTY · 0.1.4 · 59.9KiB	PIGSTY 0.1.4 u22.x86_64.pg16 : postgresql-16-is-jsonb-valid postgresql-16-is-jsonb-valid_0.1.4-1PGSTY~jammy_amd64.deb PIGSTY · 0.1.4 · 59.9KiB	PIGSTY 0.1.4 u22.x86_64.pg15 : postgresql-15-is-jsonb-valid postgresql-15-is-jsonb-valid_0.1.4-1PGSTY~jammy_amd64.deb PIGSTY · 0.1.4 · 60.0KiB	PIGSTY 0.1.4 u22.x86_64.pg14 : postgresql-14-is-jsonb-valid postgresql-14-is-jsonb-valid_0.1.4-1PGSTY~jammy_amd64.deb PIGSTY · 0.1.4 · 61.3KiB
u22.aarch64	PIGSTY 0.1.4 u22.aarch64.pg18 : postgresql-18-is-jsonb-valid postgresql-18-is-jsonb-valid_0.1.4-1PGSTY~jammy_arm64.deb PIGSTY · 0.1.4 · 53.2KiB	PIGSTY 0.1.4 u22.aarch64.pg17 : postgresql-17-is-jsonb-valid postgresql-17-is-jsonb-valid_0.1.4-1PGSTY~jammy_arm64.deb PIGSTY · 0.1.4 · 59.3KiB	PIGSTY 0.1.4 u22.aarch64.pg16 : postgresql-16-is-jsonb-valid postgresql-16-is-jsonb-valid_0.1.4-1PGSTY~jammy_arm64.deb PIGSTY · 0.1.4 · 59.3KiB	PIGSTY 0.1.4 u22.aarch64.pg15 : postgresql-15-is-jsonb-valid postgresql-15-is-jsonb-valid_0.1.4-1PGSTY~jammy_arm64.deb PIGSTY · 0.1.4 · 59.3KiB	PIGSTY 0.1.4 u22.aarch64.pg14 : postgresql-14-is-jsonb-valid postgresql-14-is-jsonb-valid_0.1.4-1PGSTY~jammy_arm64.deb PIGSTY · 0.1.4 · 60.5KiB
u24.x86_64	PIGSTY 0.1.4 u24.x86_64.pg18 : postgresql-18-is-jsonb-valid postgresql-18-is-jsonb-valid_0.1.4-1PGSTY~noble_amd64.deb PIGSTY · 0.1.4 · 53.2KiB	PIGSTY 0.1.4 u24.x86_64.pg17 : postgresql-17-is-jsonb-valid postgresql-17-is-jsonb-valid_0.1.4-1PGSTY~noble_amd64.deb PIGSTY · 0.1.4 · 53.3KiB	PIGSTY 0.1.4 u24.x86_64.pg16 : postgresql-16-is-jsonb-valid postgresql-16-is-jsonb-valid_0.1.4-1PGSTY~noble_amd64.deb PIGSTY · 0.1.4 · 53.3KiB	PIGSTY 0.1.4 u24.x86_64.pg15 : postgresql-15-is-jsonb-valid postgresql-15-is-jsonb-valid_0.1.4-1PGSTY~noble_amd64.deb PIGSTY · 0.1.4 · 53.1KiB	PIGSTY 0.1.4 u24.x86_64.pg14 : postgresql-14-is-jsonb-valid postgresql-14-is-jsonb-valid_0.1.4-1PGSTY~noble_amd64.deb PIGSTY · 0.1.4 · 55.0KiB
u24.aarch64	PIGSTY 0.1.4 u24.aarch64.pg18 : postgresql-18-is-jsonb-valid postgresql-18-is-jsonb-valid_0.1.4-1PGSTY~noble_arm64.deb PIGSTY · 0.1.4 · 52.7KiB	PIGSTY 0.1.4 u24.aarch64.pg17 : postgresql-17-is-jsonb-valid postgresql-17-is-jsonb-valid_0.1.4-1PGSTY~noble_arm64.deb PIGSTY · 0.1.4 · 52.6KiB	PIGSTY 0.1.4 u24.aarch64.pg16 : postgresql-16-is-jsonb-valid postgresql-16-is-jsonb-valid_0.1.4-1PGSTY~noble_arm64.deb PIGSTY · 0.1.4 · 52.6KiB	PIGSTY 0.1.4 u24.aarch64.pg15 : postgresql-15-is-jsonb-valid postgresql-15-is-jsonb-valid_0.1.4-1PGSTY~noble_arm64.deb PIGSTY · 0.1.4 · 52.5KiB	PIGSTY 0.1.4 u24.aarch64.pg14 : postgresql-14-is-jsonb-valid postgresql-14-is-jsonb-valid_0.1.4-1PGSTY~noble_arm64.deb PIGSTY · 0.1.4 · 54.6KiB
u26.x86_64	PIGSTY 0.1.4 u26.x86_64.pg18 : postgresql-18-is-jsonb-valid postgresql-18-is-jsonb-valid_0.1.4-1PGSTY~resolute_amd64.deb PIGSTY · 0.1.4 · 52.5KiB	PIGSTY 0.1.4 u26.x86_64.pg17 : postgresql-17-is-jsonb-valid postgresql-17-is-jsonb-valid_0.1.4-1PGSTY~resolute_amd64.deb PIGSTY · 0.1.4 · 52.4KiB	PIGSTY 0.1.4 u26.x86_64.pg16 : postgresql-16-is-jsonb-valid postgresql-16-is-jsonb-valid_0.1.4-1PGSTY~resolute_amd64.deb PIGSTY · 0.1.4 · 52.4KiB	PIGSTY 0.1.4 u26.x86_64.pg15 : postgresql-15-is-jsonb-valid postgresql-15-is-jsonb-valid_0.1.4-1PGSTY~resolute_amd64.deb PIGSTY · 0.1.4 · 52.5KiB	PIGSTY 0.1.4 u26.x86_64.pg14 : postgresql-14-is-jsonb-valid postgresql-14-is-jsonb-valid_0.1.4-1PGSTY~resolute_amd64.deb PIGSTY · 0.1.4 · 54.4KiB
u26.aarch64	PIGSTY 0.1.4 u26.aarch64.pg18 : postgresql-18-is-jsonb-valid postgresql-18-is-jsonb-valid_0.1.4-1PGSTY~resolute_arm64.deb PIGSTY · 0.1.4 · 51.9KiB	PIGSTY 0.1.4 u26.aarch64.pg17 : postgresql-17-is-jsonb-valid postgresql-17-is-jsonb-valid_0.1.4-1PGSTY~resolute_arm64.deb PIGSTY · 0.1.4 · 51.8KiB	PIGSTY 0.1.4 u26.aarch64.pg16 : postgresql-16-is-jsonb-valid postgresql-16-is-jsonb-valid_0.1.4-1PGSTY~resolute_arm64.deb PIGSTY · 0.1.4 · 51.8KiB	PIGSTY 0.1.4 u26.aarch64.pg15 : postgresql-15-is-jsonb-valid postgresql-15-is-jsonb-valid_0.1.4-1PGSTY~resolute_arm64.deb PIGSTY · 0.1.4 · 51.8KiB	PIGSTY 0.1.4 u26.aarch64.pg14 : postgresql-14-is-jsonb-valid postgresql-14-is-jsonb-valid_0.1.4-1PGSTY~resolute_arm64.deb PIGSTY · 0.1.4 · 53.8KiB

构建

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

pig build pkg is_jsonb_valid         # 构建 RPM / DEB 包

安装

您可以直接安装 is_jsonb_valid 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：

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

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

安装

pig install is_jsonb_valid;          # 当前活跃 PG 版本安装

pig

pig ext install -y is_jsonb_valid -v 18  # PG 18
pig ext install -y is_jsonb_valid -v 17  # PG 17
pig ext install -y is_jsonb_valid -v 16  # PG 16
pig ext install -y is_jsonb_valid -v 15  # PG 15
pig ext install -y is_jsonb_valid -v 14  # PG 14

dnf

dnf install -y is_jsonb_valid_18       # PG 18
dnf install -y is_jsonb_valid_17       # PG 17
dnf install -y is_jsonb_valid_16       # PG 16
dnf install -y is_jsonb_valid_15       # PG 15
dnf install -y is_jsonb_valid_14       # PG 14

apt

apt install -y postgresql-18-is-jsonb-valid   # PG 18
apt install -y postgresql-17-is-jsonb-valid   # PG 17
apt install -y postgresql-16-is-jsonb-valid   # PG 16
apt install -y postgresql-15-is-jsonb-valid   # PG 15
apt install -y postgresql-14-is-jsonb-valid   # PG 14

创建扩展：

CREATE EXTENSION is_jsonb_valid;

用法

来源：

is_jsonb_valid 使用原生代码，根据 JSON Schema Draft 4 或 Draft 7 对 JSONB 值进行布尔校验。它适合只需要通过或失败结果的检查与谓词；校验失败时不会返回路径或关键字诊断信息。

核心流程

选择与模式草案匹配的函数，第一个参数传模式，第二个参数传被校验的值。

CREATE EXTENSION is_jsonb_valid;

SELECT is_jsonb_valid(
    '{"type":"object","required":["id"],"properties":{"id":{"type":"integer"}}}'::jsonb,
    '{"id":42}'::jsonb
);

SELECT is_jsonb_valid_draft_v7(
    '{"if":{"exclusiveMaximum":0},"else":{"multipleOf":2}}'::jsonb,
    '4'::jsonb
);

0.1.4 版中的两个函数都具有严格与不可变属性。当模式保持稳定时，可以把它们用于约束和索引。

CREATE TABLE events (
    payload jsonb NOT NULL,
    CONSTRAINT events_payload_valid CHECK (
        is_jsonb_valid(
            '{"type":"object","required":["id"]}'::jsonb,
            payload
        )
    )
);

草案边界与限制

基础校验器遵循 Draft 4，名称中明确标出的另一个函数遵循 Draft 7。必须主动选择，因为不同草案中的关键字含义不同，扩展也不会根据模式声明自动推断草案。

在固定的源码版本中，不支持远端引用。本地引用仅限于从模式根可达的定义，也不会解析引用链上的标识符变化。此外不支持格式校验。因此，返回真只说明数据满足已实现的子集，并不代表完整 JSON Schema 规范中的全部行为。

扩展没有声明预加载或重启要求。应把模式字面量与应用预期纳入版本控制，并在约束依赖该扩展时加入有代表性的有效与无效用例。

is_jsonb_valid

概览

版本

构建

安装

用法

核心流程

草案边界与限制

这个页面对您有帮助吗？