TL;DR
SELECT json_agg(t) FROM t
para una matriz JSON de objetos, y
SELECT
json_build_object(
'a', json_agg(t.a),
'b', json_agg(t.b)
)
FROM t
para un objeto JSON de matrices.
Lista de objetos
Esta sección describe cómo generar una matriz de objetos JSON, con cada fila convertida en un solo objeto. El resultado se ve así:
[{"a":1,"b":"value1"},{"a":2,"b":"value2"},{"a":3,"b":"value3"}]
9.3 y más
El json_agg
La función produce este resultado fuera de la caja. Automáticamente descubre cómo convertir su entrada en JSON y la agrega en una matriz.
SELECT json_agg(t) FROM t
No hay jsonb
(introducido en 9.4) versión de json_agg
. Puede agregar las filas en una matriz y luego convertirlas:
SELECT to_jsonb(array_agg(t)) FROM t
o combinar json_agg
con un elenco:
SELECT json_agg(t)::jsonb FROM t
Mis pruebas sugieren que agregarlos primero en una matriz es un poco más rápido. Sospecho que esto se debe a que el elenco tiene que analizar todo el resultado JSON.
9.2
9.2 no tiene el json_agg
o to_json
funciones, por lo que necesita usar el antiguo array_to_json
:
SELECT array_to_json(array_agg(t)) FROM t
Opcionalmente, puede incluir un row_to_json
llamar en la consulta:
SELECT array_to_json(array_agg(row_to_json(t))) FROM t
Esto convierte cada fila en un objeto JSON, agrega los objetos JSON como una matriz y luego convierte la matriz en una matriz JSON.
No pude discernir ninguna diferencia de rendimiento significativa entre los dos.
Objeto de listas
Esta sección describe cómo generar un objeto JSON, donde cada clave es una columna en la tabla y cada valor es una matriz de los valores de la columna. Es el resultado que se ve así:
{"a":[1,2,3], "b":["value1","value2","value3"]}
9.5 y más
Podemos aprovechar el json_build_object
función:
SELECT
json_build_object(
'a', json_agg(t.a),
'b', json_agg(t.b)
)
FROM t
También puede agregar las columnas, crear una sola fila y luego convertirla en un objeto:
SELECT to_json(r)
FROM (
SELECT
json_agg(t.a) AS a,
json_agg(t.b) AS b
FROM t
) r
Tenga en cuenta que el alias de las matrices es absolutamente necesario para garantizar que el objeto tenga los nombres deseados.
Cuál es más claro es una cuestión de opinión. Si usa json_build_object
función, recomiendo poner un par clave/valor en una línea para mejorar la legibilidad.
También podría usar array_agg
en lugar de json_agg
, pero mis pruebas indican que json_agg
es un poco más rápido.
No hay jsonb
versión del json_build_object
función. Puede agregar en una sola fila y convertir:
SELECT to_jsonb(r)
FROM (
SELECT
array_agg(t.a) AS a,
array_agg(t.b) AS b
FROM t
) r
A diferencia de otras consultas para este tipo de resultado, array_agg
parece ser un poco más rápido cuando se usa to_jsonb
. Sospecho que esto se debe al análisis general y la validación del resultado JSON de json_agg
.
O puedes usar un molde explícito:
SELECT
json_build_object(
'a', json_agg(t.a),
'b', json_agg(t.b)
)::jsonb
FROM t
El to_jsonb
la versión te permite evitar el yeso y es más rápida, según mis pruebas; de nuevo, sospecho que esto se debe a la sobrecarga de analizar y validar el resultado.
9.4 y 9.3
El json_build_object
La función era nueva en 9.5, por lo que debe agregar y convertir a un objeto en versiones anteriores:
SELECT to_json(r)
FROM (
SELECT
json_agg(t.a) AS a,
json_agg(t.b) AS b
FROM t
) r
o
SELECT to_jsonb(r)
FROM (
SELECT
array_agg(t.a) AS a,
array_agg(t.b) AS b
FROM t
) r
dependiendo de si quieres json
o jsonb
.
(9.3 no tiene jsonb
.)
9.2
En 9.2, ni siquiera to_json
existe Debe usar row_to_json
:
SELECT row_to_json(r)
FROM (
SELECT
array_agg(t.a) AS a,
array_agg(t.b) AS b
FROM t
) r
Documentación
Encuentre la documentación para las funciones JSON en Funciones JSON.
json_agg
está en la página de funciones agregadas.
Diseño
Si el rendimiento es importante, asegúrese de comparar sus consultas con su propio esquema y datos, en lugar de confiar en mis pruebas.
Si es un buen diseño o no realmente depende de su aplicación específica. En términos de mantenibilidad, no veo ningún problema en particular. Simplifica el código de su aplicación y significa que hay menos que mantener en esa parte de la aplicación. Si PG puede brindarle exactamente el resultado que necesita de inmediato, la única razón que se me ocurre para no usarlo sería por consideraciones de rendimiento. No reinventes la rueda y todo eso.
Nulos
Las funciones agregadas normalmente devuelven NULL
cuando operan sobre filas cero. Si esta es una posibilidad, es posible que desee utilizar COALESCE
para evitarlos. Un par de ejemplos:
SELECT COALESCE(json_agg(t), '[]'::json) FROM t
O
SELECT to_jsonb(COALESCE(array_agg(t), ARRAY[]::t[])) FROM t
Gracias a Hannes Landeholm por señalar esto