Jak funguje JSONB a kdy jej máte používat?

Question

Accepted Answer

**`JSONB`** je binární JSON typ PostgreSQL — ukládá JSON data v efektivním, **dotazovatelném a indexovatelném** formátu. Umožňuje vám ukládat flexibilní, částečně strukturovaná data v relační databázi a kombinuje relační integritu s flexibilitou podobnou NoSQL. Je to jedna z nejsilnějších funkcí Postgresu.

## JSONB vs 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).
```

## Ukládání a dotazování 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
```

Operátory: `->` (získat JSONB pole), `->>` (získat jako text), `@>` (obsahování), `?` (klíč existuje), `#>>` (vnořená cesta). Ty činí JSONB bohatě dotazovatelným — na rozdíl od ukládání JSON jako prostého textu.

## Indexování JSONB (klíč k výkonu)

```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'));
```

## Kdy používat JSONB (a kdy ne)

```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.
```

## Proč je to důležité

JSONB je jednou z nejdůležitějších a nejcharakterističtějších funkcí PostgreSQL a jeho pochopení je velmi cenné, protože vám umožňuje **ukládat a efektivně dotazovat částečně strukturovaná data v relační databázi** — kombinuje integritu, transakce a relační sílu Postgresu s flexibilitou dokumentového/NoSQL úložiště, což je zásadní schopnost pro moderní aplikace.

Klíčová výhoda oproti ukládání JSON jako prostého textu (nebo typu `JSON`) je, že **JSONB je dotazovatelný a indexovatelný**: bohaté operátory (`->`, `->>`, `@>`, `?`) vám umožňují extrahovat a filtrovat obsah JSON a **GIN indexy** (nebo indexy na extrahovaných polích) činí tyto dotazy rychlými — takže získáte flexibilitu podobnou dokumentovému úložišti bez ztráty výkonu dotazů.

To dělá JSONB ideálním pro flexibilní nebo variabilní atributy, nastavení, API payloady, řídká data a vyvíjející se schémata — běžné moderní potřeby, které by jinak vyžadovaly NoSQL databázi nebo nešikovné návrhy schémat.

Pochopení rozlišení **JSONB vs JSON** (JSONB pro téměř všechny případy), operátorů dotazů, **indexování** (základní pro výkon) a zásadně **kdy používat JSONB versus normální sloupce** (JSONB pro flexibilní/variabilní/částečně strukturovaná data, normální sloupce pro dobře strukturovaná relačně dotazovaná data — často kombinování obojího) odráží zralý návrh.

Protože schopnost zpracovávat flexibilní, částečně strukturovaná data je čím dál důležitější a JSONB to poskytuje v rámci robustní relační databáze (často eliminuje potřebu samostatného NoSQL úložiště), pochopení JSONB — jeho dotazování, indexování a vhodné použití — je cenná, často relevantní znalost, která je klíčovým důvodem, proč je PostgreSQL tak populární pro moderní aplikace a charakteristikou využívání plné síly Postgresu.