Colonnes JSONB : à quoi elles servent et quand une colonne classique vaut mieux

Ce que c'est

PostgreSQL dispose de deux types JSON. La documentation indique que json stocke une copie exacte du texte d'entrée, tandis que jsonb stocke une forme binaire décomposée qui ne préserve ni les espaces, ni l'ordre des clés, ni les clés dupliquées, est légèrement plus lent à saisir et nettement plus rapide à traiter, et prend en charge l'indexation ; elle recommande jsonb pour la plupart des applications. L'inclusion (@>), l'existence de clé (?) et les opérateurs de chemin JSON (@?, @@) peuvent utiliser un index GIN ; la classe d'opérateur non par défaut jsonb_path_ops ne prend pas en charge les opérateurs d'existence de clé, mais elle est en général bien plus petite que la classe par défaut et recherche typiquement mieux. La section consacrée à la conception recommande des documents à la structure relativement fixe et à la taille maîtrisable, car toute mise à jour verrouille la ligne entière.

Pourquoi c'est important

jsonb évite les migrations pour les attributs qui changent souvent ou sont définis par un tiers : charges utiles de webhooks, champs définis par la personne utilisatrice, réglages par tenant. Utilisé pour des données centrales, il supprime la capacité de la base de données à imposer des types, l'unicité et des références, et déplace toute validation dans le code applicatif, où chaque écrivain doit la répéter.

Comment l'appliquer

• Utiliser jsonb pour les charges utiles brutes conservées à des fins d'audit, les attributs épars qui diffèrent selon le type d'enregistrement, les réglages lus et écrits en bloc, et les données dont le schéma appartient à un autre système.
• Utiliser des colonnes pour tout ce qui est filtré, joint, agrégé ou trié dans la plupart des requêtes, tout ce qui porte une clé étrangère, une contrainte d'unicité ou un CHECK, ainsi que pour l'argent, les dates et les identifiants qui nécessitent leur propre type.
• Indexer avec GIN (col jsonb_path_ops) pour les requêtes d'inclusion ; pour une clé très sollicitée, un index d'expression sur (col->>'key') ou une colonne générée est plus petit et prend en charge les recherches d'égalité et de plage.
• Contraindre la forme avec un CHECK utilisant jsonb_typeof sur les clés requises, ou valider par rapport à un schéma JSON avant l'écriture ; documenter les clés attendues à côté de la colonne.
• Mettre à jour les chemins avec jsonb_set ou || plutôt qu'en faisant un aller-retour par l'application, en gardant à l'esprit que la version de la ligne est de toute façon réécrite.

Pièges

Choisir json parce qu'il paraît plus simple : il ne peut pas être indexé de la même façon et conserve les doublons et l'ordre des clés que jsonb abandonne. La documentation note que jsonb rejette l'échappement \u0000 et les nombres hors de la plage numeric. Des documents volumineux mis à jour champ par champ provoquent du gonflement et des conflits de verrous. Un index GIN n'aide ni ORDER BY ni les prédicats de plage sur une clé.