Formations — 1 037 leçons en français

Accueil › SQL & bases de données › JSON et jsonb : quand et comment

JSON et jsonb : quand et comment

Types et fonctionsintermediaire

jsonb permet de stocker des données semi-structurées dans une base relationnelle. C'est utile — et souvent mal utilisé.

ALTER TABLE commande ADD COLUMN metadonnees jsonb NOT NULL DEFAULT '{}';

UPDATE commande SET metadonnees = '{"canal": "mobile", "campagne": "rentree", "ab_test": "B"}'
WHERE id = 1042;

-- Navigation
SELECT metadonnees ->> 'canal'                  AS canal,      -- texte
       metadonnees -> 'utm'  ->> 'source'       AS source      -- navigation puis texte
FROM commande;

-- Recherche, avec index
CREATE INDEX commande_meta_gin ON commande USING gin (metadonnees);
SELECT * FROM commande WHERE metadonnees @> '{"canal": "mobile"}';

Retenez la distinction -> / ->> : le premier renvoie du jsonb, le second du texte. WHERE data -> 'canal' = 'mobile' ne fonctionne pas ; data ->> 'canal' = 'mobile', oui.

La vraie question n'est pas technique mais de conception : ce champ mérite-t-il une colonne ?

Le champ… alors
est filtré, trié ou contraint régulièrement colonne
existe pour toutes les lignes colonne
varie réellement d'une ligne à l'autre jsonb
est une charge utile externe à conserver telle quelle jsonb

Une colonne apporte le typage, les contraintes, les valeurs par défaut et des statistiques fiables pour l'optimiseur. jsonb n'apporte que de la souplesse — précieuse là où elle est nécessaire, coûteuse ailleurs.

Les termes à connaître

jsonb

JSON stocké sous forme binaire décomposée : indexable, opérateurs efficaces, clés dédoublonnées et réordonnées. C'est le type à utiliser — json ne conserve que le texte brut.

-> et ->>

-> extrait une valeur en jsonb (utilisable pour naviguer plus loin), ->> l'extrait en texte. Confondre les deux est l'erreur de syntaxe la plus fréquente.

@> (contient)

Teste qu'un document contient une structure : metadonnees @> '{"canal":"mobile"}'. C'est l'opérateur que l'index GIN accélère.

jsonb_path_query / #>>

Navigation par chemin : data #>> '{client,adresse,ville}' ou la syntaxe JSONPath jsonb_path_query(data, '$.lignes[*].produit').

jsonb_to_recordset

Transforme un tableau JSON en lignes exploitables comme une table : le pont entre un document et le relationnel.

Index GIN jsonb_path_ops

Variante d'index GIN plus compacte et plus rapide, mais limitée à l'opérateur @>. Le jsonb_ops par défaut couvre plus d'opérateurs, au prix de la taille.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.