Hoe werkt JSONB en wanneer zou je het moeten gebruiken?

Question

Accepted Answer

**`JSONB`** is het binaire JSON-type van PostgreSQL — het slaat JSON-gegevens op in een efficiënt, **bevraagbaar en indexeerbaar** formaat. Het stelt je in staat flexibele, semi-gestructureerde gegevens in een relationele database op te slaan, waardoor relationele integriteit wordt gecombineerd met NoSQL-achtige flexibiliteit. Het is een van de krachtigste functies van Postgres.

## JSONB versus 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 opslaan en bevragen

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

Operators: `->` (JSONB-veld ophalen), `->>` (als tekst ophalen), `@>` (containment), `?` (sleutel bestaat), `#>>` (genest pad). Deze maken JSONB rijkelijk bevraagbaar — anders dan JSON als platte tekst op te slaan.

## JSONB indexeren (essentieel voor prestaties)

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

## Wanneer JSONB gebruiken (en wanneer niet)

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

## Waarom het belangrijk is

JSONB is een van de belangrijkste en meest onderscheidende functies van PostgreSQL, en het begrijpen ervan is waardevol omdat je daarmee **semi-gestructureerde gegevens efficiënt kunt opslaan en bevragen binnen een relationele database** — waardoor de integriteit, transacties en relationele kracht van Postgres worden gecombineerd met de flexibiliteit van een document-/NoSQL-winkel, wat een groot voordeel is voor moderne toepassingen.

Het belangrijkste voordeel ten opzichte van het opslaan van JSON als platte tekst (of het `JSON`-type) is dat **JSONB bevraagbaar en indexeerbaar is**: rijke operators (`->`, `->>`, `@>`, `?`) stellen je in staat JSON-inhoud uit te pakken en erop te filteren, en **GIN-indexen** (of indexen op geëxtraheerde velden) maken deze query's snel — dus je krijgt flexibiliteit zoals in een document-winkel zonder query-prestaties op te offeren.

Dit maakt JSONB ideaal voor flexibele of variabele attributen, instellingen, API-payloads, verspreide gegevens en evoluerende schema's — veel voorkomende moderne behoeften die anders een NoSQL-database of lastige schemaontwerpen zouden vereisen.

Begrip van het **JSONB versus JSON**-onderscheid (JSONB voor bijna alle gevallen), de query-operators, **indexeren** (essentieel voor prestaties) en cruciaal **wanneer JSONB moet worden gebruikt versus normale kolommen** (JSONB voor flexibele/variabele/semi-gestructureerde gegevens, normale kolommen voor goed gestructureerde relationeel bevraagde gegevens — beide mengen is vaak het geval) weerspiegelt volwassen ontwerpinzicht.

Omdat het vermogen om flexibele, semi-gestructureerde gegevens te verwerken steeds belangrijker wordt, en omdat JSONB dit biedt binnen een robuuste relationele database (wat vaak de behoefte aan een aparte NoSQL-winkel elimineert), is het begrijpen van JSONB — het bevragen ervan, indexeren en passend gebruik — waardevol, frequently-relevant kennisgebied en een kernreden waarom PostgreSQL zo populair is voor moderne toepassingen en een kenmerk van het benutten van de volledige kracht van Postgres.