PostgreSQL / 系统课时
理解 JSON 与 JSONB 差异
理解 JSON 与 JSONB 差异
PostgreSQL 的 json 与 jsonb 都能保存 JSON 文档,但它们在写入表示、格式保留、字段访问和索引能力上存在明显差异。本课通过可运行 SQL 观察关键行为,并给出面向查询与治理场景的选型规则。
学习目标
- 解释
json与jsonb在保存和读取阶段的核心差异 - 判断重复键、空白和键顺序在两种类型中的处理结果
- 根据查询与索引需求选择合适的数据类型
两种类型的保存方式
json 会验证输入是否符合 JSON 语法,并保存输入的文本表示。空白、对象键顺序和重复键可以保留;后续通过 JSON 操作符访问内部值时,需要再次解析文本。
jsonb 会在写入时解析 JSON 并转换为二进制表示。它不保留无意义空白,也不保证对象键维持输入顺序;同一对象出现重复键时,只保留最后一个键值。因此,依赖原始文本形式的场景不能把 jsonb 当作无损文本存档。
直接观察格式与重复键
下面把同一段输入分别转换为 json 和 jsonb,再显式转换为 text,可以直接看到两种表示的差异。
SELECT
'{"name":"first", "name":"second", "count": 2}'::json::text AS json_text,
'{"name":"first", "name":"second", "count": 2}'::jsonb::text AS jsonb_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 会话中直接运行。
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;预期结果
payload
---------------------------------------------
{"type": "payment", "status": "success"}
(1 row)这条查询直接表达“文档包含这些键值”。在真实大表中,如果该查询模式稳定且频繁,再评估 JSONB GIN 索引是否值得建立;判断依据应包括查询频率、选择性和额外写入成本,而不是看到 JSONB 就默认建索引。
什么时候仍然选择 JSON
当业务明确需要保留输入文本的空白、键顺序或重复键,例如存储需要按输入形式回看的外部 JSON 报文时,json 更符合语义。如果要求连非 JSON 前后缀、编码细节或其他原始载荷也逐字保存,则应额外保存原始 text,不要把 JSON 类型当作通用原文归档格式。
对于需要查询动态属性、事件元数据或其他半结构化业务数据的场景,jsonb 通常是默认起点;只有“保留输入文本表示”本身就是明确需求时,才优先考虑 json。