Columnas JSONB: para qué sirven y cuándo es mejor una columna

Qué es

PostgreSQL tiene dos tipos JSON. La documentación afirma que json almacena una copia exacta del texto de entrada, mientras que jsonb almacena una forma binaria descompuesta que no conserva los espacios en blanco, el orden de las claves ni las claves duplicadas, es ligeramente más lenta al ingresar y notablemente más rápida al procesar, y admite indexación; recomienda jsonb para la mayoría de las aplicaciones. Los operadores de contención (@>), de existencia de clave (?) y de ruta JSON (@?, @@) pueden usar un índice GIN; la clase de operador no predeterminada jsonb_path_ops no admite los operadores de existencia de clave, pero suele ser mucho más pequeña que la clase predeterminada y por lo general busca mejor. La sección de diseño recomienda documentos con una estructura algo fija y un tamaño manejable, porque cualquier actualización bloquea la fila entera.

Por qué importa

jsonb elimina las migraciones para atributos que cambian con frecuencia o que define otra parte: cargas útiles de webhooks, campos definidos por el usuario, configuraciones por inquilino. Usado para datos centrales, elimina la capacidad de la base de datos de imponer tipos, unicidad y referencias, y traslada toda validación al código de la aplicación, donde cada escritor debe repetirla.

Cómo aplicarlo

• Usar jsonb para cargas útiles en bruto conservadas con fines de auditoría, atributos dispersos que difieren según el tipo de registro, configuraciones que se leen y escriben como un todo, y datos cuyo esquema pertenece a otro sistema.
• Usar columnas para todo lo que se filtra, une (join), agrega u ordena en la mayoría de las consultas, todo lo que tiene una clave foránea, unicidad o CHECK, y para el dinero, las fechas y los identificadores que necesitan su propio tipo.
• Indexar con GIN (col jsonb_path_ops) para consultas de contención; para una clave de uso frecuente, un índice de expresión sobre (col->>'key') o una columna generada es más pequeño y admite recorridos de igualdad y de rango.
• Restringir la forma con un CHECK que use jsonb_typeof sobre las claves obligatorias, o validar contra un JSON Schema antes de escribir; documentar las claves esperadas junto a la columna.
• Actualizar rutas con jsonb_set o || en lugar de ir y volver a través de la aplicación, teniendo en cuenta que la versión de la fila se reescribe de todos modos.

Trampas

Elegir json porque parece más simple: no se puede indexar de la misma manera y conserva los duplicados y el orden de las claves que jsonb descarta. La documentación señala que jsonb rechaza el escape \u0000 y los números fuera del rango de numeric. Los documentos grandes actualizados campo por campo provocan hinchazón (bloat) y contención de bloqueos. Un índice GIN no ayuda a ORDER BY ni a los predicados de rango sobre una clave.