pgsql: Add option force_array for COPY JSON FORMAT

From: Andrew Dunstan <andrew(at)dunslane(dot)net>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Add option force_array for COPY JSON FORMAT
Date: 2026-03-20 12:41:00
Message-ID: E1w3Z9v-000dj6-1w@gemulon.postgresql.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-committers

Add option force_array for COPY JSON FORMAT

This adds the force_array option, which is available exclusively
when using COPY TO with the JSON format.

When enabled, this option wraps the output in a top-level JSON array
(enclosed in square brackets with comma-separated elements), making the
entire result a valid single JSON value. Without this option, the
default behavior is to output a stream of independent JSON objects.

Attempting to use this option with COPY FROM or with formats other than
JSON will raise an error.

Author: Joe Conway <mail(at)joeconway(dot)com>
Author: jian he <jian(dot)universality(at)gmail(dot)com>
Reviewed-by: Junwang Zhao <zhjwpku(at)gmail(dot)com>
Reviewed-by: Masahiko Sawada <sawada(dot)mshk(at)gmail(dot)com>
Reviewed-by: Florents Tselai <florents(dot)tselai(at)gmail(dot)com>
Reviewed-by: Andrew Dunstan <andrew(at)dunslane(dot)net>
Discussion: https://postgr.es/m/CALvfUkBxTYy5uWPFVwpk_7ii2zgT07t3d-yR_cy4sfrrLU%3Dkcg%40mail.gmail.com
Discussion: https://postgr.es/m/6a04628d-0d53-41d9-9e35-5a8dc302c34c@joeconway.com

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/4c0390ac53b745c2800f6aa3d9ee2515d6ab499b

Modified Files
--------------
doc/src/sgml/ref/copy.sgml | 30 ++++++++++++++++++++++++++++++
src/backend/commands/copy.c | 13 +++++++++++++
src/backend/commands/copyto.c | 38 ++++++++++++++++++++++++++++++++++++--
src/bin/psql/tab-complete.in.c | 2 +-
src/include/commands/copy.h | 1 +
src/test/regress/expected/copy.out | 37 +++++++++++++++++++++++++++++++++++++
src/test/regress/sql/copy.sql | 13 +++++++++++++
7 files changed, 131 insertions(+), 3 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Robert Haas 2026-03-20 12:53:59 pgsql: test_plan_advice: Set TAP test priority 50 in meson.build.
Previous Message Peter Eisentraut 2026-03-20 10:08:46 pgsql: Cleanup users and roles in graph_table_rls test