Convierte un valor —un número, un texto, un array o una fila entera de la tabla— en JSON.
TO_JSONB(<valor>)
Un número pasa a ser un número JSON; un texto, una cadena JSON; un array, un array JSON. Si pasas la propia fila de la tabla (su alias en la consulta), obtienes un objeto con todas las columnas: útil para enviar un registro a la aplicación en un solo campo o guardarlo en un registro de cambios.
employees
| name | department | salary | bonus | phone |
|---|---|---|---|---|
| Emma | backend | 1200 | 300 | +44 7700 900123 |
| Liam | backend | 1000 | NULL | NULL |
| Olivia | frontend | 1350 | 150 | +44 7700 900456 |
| Noah | frontend | 950 | NULL | +44 7700 900789 |
| Sophia | design | 1200 | 200 | NULL |
Estas tablas ya están creadas en el entorno de pruebas y los ejemplos de abajo las usan. ¿Quieres repetirlo en tu propia base de datos? Copia el SQL.
| number | text_value | array_value |
|---|---|---|
| 42 | Emma | ["sql","postgres"] |
La tabla de resultados muestra la cadena JSON sin comillas; en psql sería "Emma".
| employee |
|---|
| {"name":"Emma","bonus":300,"phone":"+44 7700 900123","salary":1200,"department":"backend"} |
| {"name":"Liam","bonus":null,"phone":null,"salary":1000,"department":"backend"} |
| {"name":"Olivia","bonus":150,"phone":"+44 7700 900456","salary":1350,"department":"frontend"} |
| {"name":"Noah","bonus":null,"phone":"+44 7700 900789","salary":950,"department":"frontend"} |
| {"name":"Sophia","bonus":200,"phone":null,"salary":1200,"department":"design"} |
Aquí e no es una columna, sino la fila entera de la tabla employees.
| name | doc |
|---|---|
| Emma | {"name":"Emma"} |
| Liam | {"name":"Liam"} |
| Olivia | {"name":"Olivia"} |
| Noah | {"name":"Noah"} |
| Sophia | {"name":"Sophia"} |
JSONB_SET espera JSON, así que primero convertimos el nombre de la columna con TO_JSONB.
Un literal de texto sin tipo no funciona: TO_JSONB('Emma') da el error could not determine polymorphic type because input has type unknown. Indica el tipo: TO_JSONB('Emma'::text).
TO_JSONB(NULL) es un NULL de SQL, no un null de JSON. Si necesitas justo null, escribe 'null'::jsonb.
Las fechas se convierten en cadenas con formato ISO: TO_JSONB(DATE '2026-09-13') da "2026-09-13", y un timestamp lleva una T en medio: "2026-09-13T15:47:00".