JSONB 如何工作，你什么时候应该使用它？

Question

Accepted Answer

**`JSONB`** 是 PostgreSQL 的二进制 JSON 类型 — 它以高效、**可查询且可索引**的格式存储 JSON 数据。它允许你在关系数据库中存储灵活的半结构化数据，将关系完整性与 NoSQL 样的灵活性相结合。这是 Postgres 最强大的功能之一。

## JSONB 与 JSON 对比

```text
JSON  → stores the exact text (preserves whitespace/key order/duplicates), parsed each query
JSONB → stores a DECOMPOSED BINARY format → slightly slower to write, but MUCH faster
        to query, and supports INDEXING and rich operators
→ Use JSONB in almost all cases (JSON only if you need exact text preservation).
```

## 存储和查询 JSONB

```sql
CREATE TABLE products (id SERIAL, attributes JSONB);
INSERT INTO products (attributes) VALUES
  ('{"color": "red", "size": "L", "tags": ["new", "sale"]}');

-- extract values
SELECT attributes->'color'   FROM products;   -- -> returns JSONB: "red"
SELECT attributes->>'color'  FROM products;   -- ->> returns TEXT: red
SELECT attributes#>>'{tags,0}' FROM products; -- nested path: first tag

-- query by content
SELECT * FROM products WHERE attributes->>'color' = 'red';
SELECT * FROM products WHERE attributes @> '{"color": "red"}';  -- containment
SELECT * FROM products WHERE attributes ? 'color';              -- key exists
```

运算符：`->` (获取 JSONB 字段)、`->>` (获取为文本)、`@>` (包含)、`?` (键存在)、`#>>` (嵌套路径)。这些使 JSONB 具有丰富的可查询性 — 与将 JSON 存储为纯文本不同。

## 索引 JSONB (性能的关键)

```sql
-- a GIN index makes containment/key queries fast
CREATE INDEX idx_attrs ON products USING GIN (attributes);
-- now WHERE attributes @> '{"color": "red"}' uses the index

-- or index a specific extracted field
CREATE INDEX idx_color ON products ((attributes->>'color'));
```

## 何时使用 JSONB (及何时不使用)

```text
✓ USE for: flexible/variable attributes, settings, API payloads, sparse fields,
  semi-structured data that varies per row, or rapidly-evolving schemas
✗ AVOID for: data that's well-structured and queried relationally → use normal columns
  (better constraints, types, and typically better performance for structured queries)
→ Mix both: structured data in columns, variable/flexible data in a JSONB column.
```

## 为什么这很重要

JSONB 是 PostgreSQL 最重要和最具特色的功能之一，理解它非常有价值，因为它让你**在关系数据库中存储和高效查询半结构化数据** — 将 Postgres 的完整性、事务和关系能力与文档/NoSQL 存储的灵活性相结合，这是现代应用程序的主要能力。

相比于将 JSON 存储为纯文本（或 `JSON` 类型），**JSONB 是可查询和可索引的**的关键优势在于：丰富的运算符（`->`, `->>`, `@>`, `?`）让你提取和筛选 JSON 内容，而 **GIN 索引**（或提取字段上的索引）使这些查询快速运行 — 所以你获得了类似文档存储的灵活性，而不牺牲查询性能。

这使 JSONB 非常适合灵活或可变属性、设置、API 负载、稀疏数据和不断演化的架构 — 这些是常见的现代需求，否则会需要 NoSQL 数据库或尴尬的架构设计。

理解 **JSONB 与 JSON 的区别**（在几乎所有情况下使用 JSONB）、查询运算符、**索引**（对性能至关重要）以及至关重要的**何时使用 JSONB 与普通列**（对灵活/可变/半结构化数据使用 JSONB，对良好结构的关系查询数据使用普通列 — 通常混合使用两者）反映了成熟的设计判断。

由于处理灵活、半结构化数据的能力日益重要，而 JSONB 在健壮的关系数据库中提供了这一能力（通常消除了单独 NoSQL 存储的需要），理解 JSONB — 它的查询、索引和恰当使用 — 是有价值的、经常相关的知识，这是 PostgreSQL 在现代应用程序中如此受欢迎的关键原因，也是充分利用 Postgres 全部能力的标志。