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 —
jsonne 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 JSONPathjsonb_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
@>. Lejsonb_opspar défaut couvre plus d'opérateurs, au prix de la taille.
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.