Saltar al contenido principal

PostgreSQL jsonb_each()

Las funciones JSON de PostgreSQL, como `jsonb_each()`, permiten manipular y recuperar eficazmente los datos almacenados en formato JSONB. La función `jsonb_each()` devuelve específicamente un conjunto de pares clave-valor de un objeto JSONB. Utilizar `jsonb_each()` puede simplificar el procesamiento de datos JSONB, ofreciendo ventajas como una iteración más sencilla sobre objetos JSONB y compatibilidad con las sólidas capacidades de indexación de PostgreSQL.

Utilización

La función `jsonb_each()` se utiliza para descomponer un objeto JSONB en pares clave-valor individuales, lo que facilita el procesamiento y la consulta de datos JSONB. Es especialmente útil cuando necesitas iterar sobre datos JSONB almacenados en una tabla PostgreSQL. La función devuelve un conjunto de registros, con `clave` como texto y `valor` como JSONB.

SELECT jsonb_each(jsonb_column)
FROM table_name;

En esta sintaxis, `jsonb_each(jsonb_column)` extrae cada par clave-valor de la columna JSONB especificada.

Ejemplos

1. Extracción básica

SELECT jsonb_each('{"name": "John", "age": 30}');

Este ejemplo descompone un objeto JSONB simple en pares clave-valor individuales, devolviendo un conjunto con "nombre" como "Juan" y "edad" como 30. La función se aplica directamente a un literal JSONB, útil a efectos de demostración.

2. Extraer de una tabla

SELECT jsonb_each(data)
FROM users_data;

Aquí, la función extrae pares clave-valor de la columna `data` de la tabla `users_data`, que almacena objetos JSONB para cada fila. Se espera que la columna `data` contenga objetos JSONB bien formados.

3. Uso de jsonb_each() con la cláusula WHERE

SELECT key, value
FROM jsonb_each('{"name": "John", "age": 30, "city": "New York"}') AS kv
WHERE kv.key = 'city';

Este ejemplo utiliza `jsonb_each()` junto con una cláusula `WHERE` para filtrar los resultados, devolviendo sólo el par clave-valor cuya clave sea "ciudad". La parte `AS kv` asigna un alias al conjunto de resultados para facilitar la consulta.

Consejos y buenas prácticas

  • Utilízalo con tipos de datos JSONB. Asegúrate de que tus datos JSON se almacenan en el formato `jsonb` para aprovechar las ventajas de indexación y rendimiento.
  • Combinar con uniones "LATERAL". Cuando trabajes con tablas, considera la posibilidad de utilizar uniones `LATERAL` para procesar los datos JSONB de forma eficiente.
  • Filtro en las teclas. Utiliza la cláusula "DONDE" para filtrar claves concretas cuando sólo necesites determinados puntos de datos.
  • Indexar columnas JSONB. Para optimizar el rendimiento, considera la posibilidad de indexar las claves JSONB consultadas con frecuencia. Utiliza índices `GIN` para los datos JSONB para acelerar las búsquedas de pares clave-valor.
  • Consideraciones sobre el rendimiento. Ten en cuenta las posibles implicaciones para el rendimiento cuando trabajes con objetos JSONB grandes, ya que `jsonb_each()` puede afectar al rendimiento de la consulta.