PostgreSQL / 系统课时

理解 JSON 与 JSONB 差异

理解 JSON 与 JSONB 差异

PostgreSQL 的 json 与 jsonb 都能保存 JSON 文档,但它们在写入表示、格式保留、字段访问和索引能力上存在明显差异。本课通过可运行 SQL 观察关键行为,并给出面向查询与治理场景的选型规则。

学习目标

  • 解释 json 与 jsonb 在保存和读取阶段的核心差异
  • 判断重复键、空白和键顺序在两种类型中的处理结果
  • 根据查询与索引需求选择合适的数据类型

两种类型的保存方式

json 会验证输入是否符合 JSON 语法,并保存输入的文本表示。空白、对象键顺序和重复键可以保留;后续通过 JSON 操作符访问内部值时,需要再次解析文本。

jsonb 会在写入时解析 JSON 并转换为二进制表示。它不保留无意义空白,也不保证对象键维持输入顺序;同一对象出现重复键时,只保留最后一个键值。因此,依赖原始文本形式的场景不能把 jsonb 当作无损文本存档。

直接观察格式与重复键

下面把同一段输入分别转换为 json 和 jsonb,再显式转换为 text,可以直接看到两种表示的差异。

sql
SELECT
    '{"name":"first", "name":"second", "count": 2}'::json::text AS json_text,
    '{"name":"first", "name":"second", "count": 2}'::jsonb::text AS jsonb_text;

预期结果

text
                    json_text                     |            jsonb_text
--------------------------------------------------+----------------------------------
 {"name":"first", "name":"second", "count": 2} | {"name": "second", "count": 2}

json 仍包含两个 name 键和原输入中的空格;jsonb 已规范化对象,只保留最后一个 name 值。实际 psql 的列宽和对齐可能不同,JSONB 对象键的显示顺序也不应作为业务约定。

查询与索引能力决定常见选择

如果文档主要是一次写入、以后整段原样取出,json 可以保留输入文本形式。若数据会被反复读取、按内部字段过滤、执行包含或路径查询,jsonb 通常更合适,因为内部结构已在写入阶段完成解析,并且 PostgreSQL 为 JSONB 提供了更丰富的操作符和索引支持。

维度 json jsonb
输入语法校验 支持 支持
保留空白和原始键顺序 是 否
重复对象键 原始文本中保留 只保留最后一个值
写入处理 较少 需要解析并转换
后续字段访问 需要重新解析文本 使用已解析表示
GIN 等 JSON 专用索引 不直接支持 支持

所谓“JSONB 查询更快”并不意味着所有 SQL 都一定更快。它的优势主要出现在重复访问内部结构、使用包含关系或路径查询,以及通过索引缩小扫描范围时;如果只是读取整段文档,实际差异仍取决于数据规模和工作负载。

JSONB 为查询治理提供基础

包含操作符 @> 可以判断左侧 JSONB 是否包含指定结构,这是后续评估 GIN 索引时常见的查询形态。下面创建临时表并执行一次包含查询,整个示例可以在同一个 PostgreSQL 会话中直接运行。

sql
CREATE TEMP TABLE event_samples (
    payload jsonb NOT NULL
);

INSERT INTO event_samples (payload)
VALUES
    ('{"type":"payment","status":"success"}'),
    ('{"type":"payment","status":"failed"}'),
    ('{"type":"login","status":"success"}');

SELECT payload
FROM event_samples
WHERE payload @> '{"type":"payment","status":"success"}'::jsonb;

预期结果

text
                   payload
---------------------------------------------
 {"type": "payment", "status": "success"}
(1 row)

这条查询直接表达“文档包含这些键值”。在真实大表中,如果该查询模式稳定且频繁,再评估 JSONB GIN 索引是否值得建立;判断依据应包括查询频率、选择性和额外写入成本,而不是看到 JSONB 就默认建索引。

什么时候仍然选择 JSON

当业务明确需要保留输入文本的空白、键顺序或重复键,例如存储需要按输入形式回看的外部 JSON 报文时,json 更符合语义。如果要求连非 JSON 前后缀、编码细节或其他原始载荷也逐字保存,则应额外保存原始 text,不要把 JSON 类型当作通用原文归档格式。

对于需要查询动态属性、事件元数据或其他半结构化业务数据的场景,jsonb 通常是默认起点;只有“保留输入文本表示”本身就是明确需求时,才优先考虑 json。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

理解 JSON 与 JSONB 差异

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通