mirror of
https://github.com/postgres/postgres.git
synced 2025-07-09 22:41:56 +03:00
SQL/JSON constructors
This patch introduces the SQL/JSON standard constructors for JSON: JSON() JSON_ARRAY() JSON_ARRAYAGG() JSON_OBJECT() JSON_OBJECTAGG() For the most part these functions provide facilities that mimic existing json/jsonb functions. However, they also offer some useful additional functionality. In addition to text input, the JSON() function accepts bytea input, which it will decode and constuct a json value from. The other functions provide useful options for handling duplicate keys and null values. This series of patches will be followed by a consolidated documentation patch. Nikita Glukhov Reviewers have included (in no particular order) Andres Freund, Alexander Korotkov, Pavel Stehule, Andrew Alsup, Erik Rijkers, Zihong Yu, Himanshu Upadhyaya, Daniel Gustafsson, Justin Pryzby. Discussion: https://postgr.es/m/cd0bb935-0158-78a7-08b5-904886deac4b@postgrespro.ru
This commit is contained in:
Andrew Dunstan
282
src/test/regress/sql/sqljson.sql
Normal file
282
src/test/regress/sql/sqljson.sql
Normal file
@ -0,0 +1,282 @@
|
||||
-- JSON_OBJECT()
|
||||
SELECT JSON_OBJECT();
|
||||
SELECT JSON_OBJECT(RETURNING json);
|
||||
SELECT JSON_OBJECT(RETURNING json FORMAT JSON);
|
||||
SELECT JSON_OBJECT(RETURNING jsonb);
|
||||
SELECT JSON_OBJECT(RETURNING jsonb FORMAT JSON);
|
||||
SELECT JSON_OBJECT(RETURNING text);
|
||||
SELECT JSON_OBJECT(RETURNING text FORMAT JSON);
|
||||
SELECT JSON_OBJECT(RETURNING text FORMAT JSON ENCODING UTF8);
|
||||
SELECT JSON_OBJECT(RETURNING text FORMAT JSON ENCODING INVALID_ENCODING);
|
||||
SELECT JSON_OBJECT(RETURNING bytea);
|
||||
SELECT JSON_OBJECT(RETURNING bytea FORMAT JSON);
|
||||
SELECT JSON_OBJECT(RETURNING bytea FORMAT JSON ENCODING UTF8);
|
||||
SELECT JSON_OBJECT(RETURNING bytea FORMAT JSON ENCODING UTF16);
|
||||
SELECT JSON_OBJECT(RETURNING bytea FORMAT JSON ENCODING UTF32);
|
||||
|
||||
SELECT JSON_OBJECT('foo': NULL::int FORMAT JSON);
|
||||
SELECT JSON_OBJECT('foo': NULL::int FORMAT JSON ENCODING UTF8);
|
||||
SELECT JSON_OBJECT('foo': NULL::json FORMAT JSON);
|
||||
SELECT JSON_OBJECT('foo': NULL::json FORMAT JSON ENCODING UTF8);
|
||||
SELECT JSON_OBJECT('foo': NULL::jsonb FORMAT JSON);
|
||||
SELECT JSON_OBJECT('foo': NULL::jsonb FORMAT JSON ENCODING UTF8);
|
||||
|
||||
SELECT JSON_OBJECT(NULL: 1);
|
||||
SELECT JSON_OBJECT('a': 2 + 3);
|
||||
SELECT JSON_OBJECT('a' VALUE 2 + 3);
|
||||
--SELECT JSON_OBJECT(KEY 'a' VALUE 2 + 3);
|
||||
SELECT JSON_OBJECT('a' || 2: 1);
|
||||
SELECT JSON_OBJECT(('a' || 2) VALUE 1);
|
||||
--SELECT JSON_OBJECT('a' || 2 VALUE 1);
|
||||
--SELECT JSON_OBJECT(KEY 'a' || 2 VALUE 1);
|
||||
SELECT JSON_OBJECT('a': 2::text);
|
||||
SELECT JSON_OBJECT('a' VALUE 2::text);
|
||||
--SELECT JSON_OBJECT(KEY 'a' VALUE 2::text);
|
||||
SELECT JSON_OBJECT(1::text: 2);
|
||||
SELECT JSON_OBJECT((1::text) VALUE 2);
|
||||
--SELECT JSON_OBJECT(1::text VALUE 2);
|
||||
--SELECT JSON_OBJECT(KEY 1::text VALUE 2);
|
||||
SELECT JSON_OBJECT(json '[1]': 123);
|
||||
SELECT JSON_OBJECT(ARRAY[1,2,3]: 'aaa');
|
||||
|
||||
SELECT JSON_OBJECT(
|
||||
'a': '123',
|
||||
1.23: 123,
|
||||
'c': json '[ 1,true,{ } ]',
|
||||
'd': jsonb '{ "x" : 123.45 }'
|
||||
);
|
||||
|
||||
SELECT JSON_OBJECT(
|
||||
'a': '123',
|
||||
1.23: 123,
|
||||
'c': json '[ 1,true,{ } ]',
|
||||
'd': jsonb '{ "x" : 123.45 }'
|
||||
RETURNING jsonb
|
||||
);
|
||||
|
||||
/*
|
||||
SELECT JSON_OBJECT(
|
||||
'a': '123',
|
||||
KEY 1.23 VALUE 123,
|
||||
'c' VALUE json '[1, true, {}]'
|
||||
);
|
||||
*/
|
||||
|
||||
SELECT JSON_OBJECT('a': '123', 'b': JSON_OBJECT('a': 111, 'b': 'aaa'));
|
||||
SELECT JSON_OBJECT('a': '123', 'b': JSON_OBJECT('a': 111, 'b': 'aaa' RETURNING jsonb));
|
||||
|
||||
SELECT JSON_OBJECT('a': JSON_OBJECT('b': 1 RETURNING text));
|
||||
SELECT JSON_OBJECT('a': JSON_OBJECT('b': 1 RETURNING text) FORMAT JSON);
|
||||
SELECT JSON_OBJECT('a': JSON_OBJECT('b': 1 RETURNING bytea));
|
||||
SELECT JSON_OBJECT('a': JSON_OBJECT('b': 1 RETURNING bytea) FORMAT JSON);
|
||||
|
||||
SELECT JSON_OBJECT('a': '1', 'b': NULL, 'c': 2);
|
||||
SELECT JSON_OBJECT('a': '1', 'b': NULL, 'c': 2 NULL ON NULL);
|
||||
SELECT JSON_OBJECT('a': '1', 'b': NULL, 'c': 2 ABSENT ON NULL);
|
||||
|
||||
SELECT JSON_OBJECT(1: 1, '1': NULL WITH UNIQUE);
|
||||
SELECT JSON_OBJECT(1: 1, '1': NULL ABSENT ON NULL WITH UNIQUE);
|
||||
SELECT JSON_OBJECT(1: 1, '1': NULL NULL ON NULL WITH UNIQUE RETURNING jsonb);
|
||||
SELECT JSON_OBJECT(1: 1, '1': NULL ABSENT ON NULL WITH UNIQUE RETURNING jsonb);
|
||||
|
||||
SELECT JSON_OBJECT(1: 1, '2': NULL, '1': 1 NULL ON NULL WITH UNIQUE);
|
||||
SELECT JSON_OBJECT(1: 1, '2': NULL, '1': 1 ABSENT ON NULL WITH UNIQUE);
|
||||
SELECT JSON_OBJECT(1: 1, '2': NULL, '1': 1 ABSENT ON NULL WITHOUT UNIQUE);
|
||||
SELECT JSON_OBJECT(1: 1, '2': NULL, '1': 1 ABSENT ON NULL WITH UNIQUE RETURNING jsonb);
|
||||
SELECT JSON_OBJECT(1: 1, '2': NULL, '1': 1 ABSENT ON NULL WITHOUT UNIQUE RETURNING jsonb);
|
||||
SELECT JSON_OBJECT(1: 1, '2': NULL, '3': 1, 4: NULL, '5': 'a' ABSENT ON NULL WITH UNIQUE RETURNING jsonb);
|
||||
|
||||
|
||||
-- JSON_ARRAY()
|
||||
SELECT JSON_ARRAY();
|
||||
SELECT JSON_ARRAY(RETURNING json);
|
||||
SELECT JSON_ARRAY(RETURNING json FORMAT JSON);
|
||||
SELECT JSON_ARRAY(RETURNING jsonb);
|
||||
SELECT JSON_ARRAY(RETURNING jsonb FORMAT JSON);
|
||||
SELECT JSON_ARRAY(RETURNING text);
|
||||
SELECT JSON_ARRAY(RETURNING text FORMAT JSON);
|
||||
SELECT JSON_ARRAY(RETURNING text FORMAT JSON ENCODING UTF8);
|
||||
SELECT JSON_ARRAY(RETURNING text FORMAT JSON ENCODING INVALID_ENCODING);
|
||||
SELECT JSON_ARRAY(RETURNING bytea);
|
||||
SELECT JSON_ARRAY(RETURNING bytea FORMAT JSON);
|
||||
SELECT JSON_ARRAY(RETURNING bytea FORMAT JSON ENCODING UTF8);
|
||||
SELECT JSON_ARRAY(RETURNING bytea FORMAT JSON ENCODING UTF16);
|
||||
SELECT JSON_ARRAY(RETURNING bytea FORMAT JSON ENCODING UTF32);
|
||||
|
||||
SELECT JSON_ARRAY('aaa', 111, true, array[1,2,3], NULL, json '{"a": [1]}', jsonb '["a",3]');
|
||||
|
||||
SELECT JSON_ARRAY('a', NULL, 'b' NULL ON NULL);
|
||||
SELECT JSON_ARRAY('a', NULL, 'b' ABSENT ON NULL);
|
||||
SELECT JSON_ARRAY(NULL, NULL, 'b' ABSENT ON NULL);
|
||||
SELECT JSON_ARRAY('a', NULL, 'b' NULL ON NULL RETURNING jsonb);
|
||||
SELECT JSON_ARRAY('a', NULL, 'b' ABSENT ON NULL RETURNING jsonb);
|
||||
SELECT JSON_ARRAY(NULL, NULL, 'b' ABSENT ON NULL RETURNING jsonb);
|
||||
|
||||
SELECT JSON_ARRAY(JSON_ARRAY('{ "a" : 123 }' RETURNING text));
|
||||
SELECT JSON_ARRAY(JSON_ARRAY('{ "a" : 123 }' FORMAT JSON RETURNING text));
|
||||
SELECT JSON_ARRAY(JSON_ARRAY('{ "a" : 123 }' FORMAT JSON RETURNING text) FORMAT JSON);
|
||||
|
||||
SELECT JSON_ARRAY(SELECT i FROM (VALUES (1), (2), (NULL), (4)) foo(i));
|
||||
SELECT JSON_ARRAY(SELECT i FROM (VALUES (NULL::int[]), ('{1,2}'), (NULL), (NULL), ('{3,4}'), (NULL)) foo(i));
|
||||
SELECT JSON_ARRAY(SELECT i FROM (VALUES (NULL::int[]), ('{1,2}'), (NULL), (NULL), ('{3,4}'), (NULL)) foo(i) RETURNING jsonb);
|
||||
--SELECT JSON_ARRAY(SELECT i FROM (VALUES (NULL::int[]), ('{1,2}'), (NULL), (NULL), ('{3,4}'), (NULL)) foo(i) NULL ON NULL);
|
||||
--SELECT JSON_ARRAY(SELECT i FROM (VALUES (NULL::int[]), ('{1,2}'), (NULL), (NULL), ('{3,4}'), (NULL)) foo(i) NULL ON NULL RETURNING jsonb);
|
||||
SELECT JSON_ARRAY(SELECT i FROM (VALUES (3), (1), (NULL), (2)) foo(i) ORDER BY i);
|
||||
-- Should fail
|
||||
SELECT JSON_ARRAY(SELECT FROM (VALUES (1)) foo(i));
|
||||
SELECT JSON_ARRAY(SELECT i, i FROM (VALUES (1)) foo(i));
|
||||
SELECT JSON_ARRAY(SELECT * FROM (VALUES (1, 2)) foo(i, j));
|
||||
|
||||
-- JSON_ARRAYAGG()
|
||||
SELECT JSON_ARRAYAGG(i) IS NULL,
|
||||
JSON_ARRAYAGG(i RETURNING jsonb) IS NULL
|
||||
FROM generate_series(1, 0) i;
|
||||
|
||||
SELECT JSON_ARRAYAGG(i),
|
||||
JSON_ARRAYAGG(i RETURNING jsonb)
|
||||
FROM generate_series(1, 5) i;
|
||||
|
||||
SELECT JSON_ARRAYAGG(i ORDER BY i DESC)
|
||||
FROM generate_series(1, 5) i;
|
||||
|
||||
SELECT JSON_ARRAYAGG(i::text::json)
|
||||
FROM generate_series(1, 5) i;
|
||||
|
||||
SELECT JSON_ARRAYAGG(JSON_ARRAY(i, i + 1 RETURNING text) FORMAT JSON)
|
||||
FROM generate_series(1, 5) i;
|
||||
|
||||
SELECT JSON_ARRAYAGG(NULL),
|
||||
JSON_ARRAYAGG(NULL RETURNING jsonb)
|
||||
FROM generate_series(1, 5);
|
||||
|
||||
SELECT JSON_ARRAYAGG(NULL NULL ON NULL),
|
||||
JSON_ARRAYAGG(NULL NULL ON NULL RETURNING jsonb)
|
||||
FROM generate_series(1, 5);
|
||||
|
||||
SELECT
|
||||
JSON_ARRAYAGG(bar),
|
||||
JSON_ARRAYAGG(bar RETURNING jsonb),
|
||||
JSON_ARRAYAGG(bar ABSENT ON NULL),
|
||||
JSON_ARRAYAGG(bar ABSENT ON NULL RETURNING jsonb),
|
||||
JSON_ARRAYAGG(bar NULL ON NULL),
|
||||
JSON_ARRAYAGG(bar NULL ON NULL RETURNING jsonb),
|
||||
JSON_ARRAYAGG(foo),
|
||||
JSON_ARRAYAGG(foo RETURNING jsonb),
|
||||
JSON_ARRAYAGG(foo ORDER BY bar) FILTER (WHERE bar > 2),
|
||||
JSON_ARRAYAGG(foo ORDER BY bar RETURNING jsonb) FILTER (WHERE bar > 2)
|
||||
FROM
|
||||
(VALUES (NULL), (3), (1), (NULL), (NULL), (5), (2), (4), (NULL)) foo(bar);
|
||||
|
||||
SELECT
|
||||
bar, JSON_ARRAYAGG(bar) FILTER (WHERE bar > 2) OVER (PARTITION BY foo.bar % 2)
|
||||
FROM
|
||||
(VALUES (NULL), (3), (1), (NULL), (NULL), (5), (2), (4), (NULL), (5), (4)) foo(bar);
|
||||
|
||||
-- JSON_OBJECTAGG()
|
||||
SELECT JSON_OBJECTAGG('key': 1) IS NULL,
|
||||
JSON_OBJECTAGG('key': 1 RETURNING jsonb) IS NULL
|
||||
WHERE FALSE;
|
||||
|
||||
SELECT JSON_OBJECTAGG(NULL: 1);
|
||||
|
||||
SELECT JSON_OBJECTAGG(NULL: 1 RETURNING jsonb);
|
||||
|
||||
SELECT
|
||||
JSON_OBJECTAGG(i: i),
|
||||
-- JSON_OBJECTAGG(i VALUE i),
|
||||
-- JSON_OBJECTAGG(KEY i VALUE i),
|
||||
JSON_OBJECTAGG(i: i RETURNING jsonb)
|
||||
FROM
|
||||
generate_series(1, 5) i;
|
||||
|
||||
SELECT
|
||||
JSON_OBJECTAGG(k: v),
|
||||
JSON_OBJECTAGG(k: v NULL ON NULL),
|
||||
JSON_OBJECTAGG(k: v ABSENT ON NULL),
|
||||
JSON_OBJECTAGG(k: v RETURNING jsonb),
|
||||
JSON_OBJECTAGG(k: v NULL ON NULL RETURNING jsonb),
|
||||
JSON_OBJECTAGG(k: v ABSENT ON NULL RETURNING jsonb)
|
||||
FROM
|
||||
(VALUES (1, 1), (1, NULL), (2, NULL), (3, 3)) foo(k, v);
|
||||
|
||||
SELECT JSON_OBJECTAGG(k: v WITH UNIQUE KEYS)
|
||||
FROM (VALUES (1, 1), (1, NULL), (2, 2)) foo(k, v);
|
||||
|
||||
SELECT JSON_OBJECTAGG(k: v ABSENT ON NULL WITH UNIQUE KEYS)
|
||||
FROM (VALUES (1, 1), (1, NULL), (2, 2)) foo(k, v);
|
||||
|
||||
SELECT JSON_OBJECTAGG(k: v ABSENT ON NULL WITH UNIQUE KEYS)
|
||||
FROM (VALUES (1, 1), (0, NULL), (3, NULL), (2, 2), (4, NULL)) foo(k, v);
|
||||
|
||||
SELECT JSON_OBJECTAGG(k: v WITH UNIQUE KEYS RETURNING jsonb)
|
||||
FROM (VALUES (1, 1), (1, NULL), (2, 2)) foo(k, v);
|
||||
|
||||
SELECT JSON_OBJECTAGG(k: v ABSENT ON NULL WITH UNIQUE KEYS RETURNING jsonb)
|
||||
FROM (VALUES (1, 1), (1, NULL), (2, 2)) foo(k, v);
|
||||
|
||||
-- Test JSON_OBJECT deparsing
|
||||
EXPLAIN (VERBOSE, COSTS OFF)
|
||||
SELECT JSON_OBJECT('foo' : '1' FORMAT JSON, 'bar' : 'baz' RETURNING json);
|
||||
|
||||
CREATE VIEW json_object_view AS
|
||||
SELECT JSON_OBJECT('foo' : '1' FORMAT JSON, 'bar' : 'baz' RETURNING json);
|
||||
|
||||
\sv json_object_view
|
||||
|
||||
DROP VIEW json_object_view;
|
||||
|
||||
-- Test JSON_ARRAY deparsing
|
||||
EXPLAIN (VERBOSE, COSTS OFF)
|
||||
SELECT JSON_ARRAY('1' FORMAT JSON, 2 RETURNING json);
|
||||
|
||||
CREATE VIEW json_array_view AS
|
||||
SELECT JSON_ARRAY('1' FORMAT JSON, 2 RETURNING json);
|
||||
|
||||
\sv json_array_view
|
||||
|
||||
DROP VIEW json_array_view;
|
||||
|
||||
-- Test JSON_OBJECTAGG deparsing
|
||||
EXPLAIN (VERBOSE, COSTS OFF)
|
||||
SELECT JSON_OBJECTAGG(i: ('111' || i)::bytea FORMAT JSON WITH UNIQUE RETURNING text) FILTER (WHERE i > 3)
|
||||
FROM generate_series(1,5) i;
|
||||
|
||||
EXPLAIN (VERBOSE, COSTS OFF)
|
||||
SELECT JSON_OBJECTAGG(i: ('111' || i)::bytea FORMAT JSON WITH UNIQUE RETURNING text) OVER (PARTITION BY i % 2)
|
||||
FROM generate_series(1,5) i;
|
||||
|
||||
CREATE VIEW json_objectagg_view AS
|
||||
SELECT JSON_OBJECTAGG(i: ('111' || i)::bytea FORMAT JSON WITH UNIQUE RETURNING text) FILTER (WHERE i > 3)
|
||||
FROM generate_series(1,5) i;
|
||||
|
||||
\sv json_objectagg_view
|
||||
|
||||
DROP VIEW json_objectagg_view;
|
||||
|
||||
-- Test JSON_ARRAYAGG deparsing
|
||||
EXPLAIN (VERBOSE, COSTS OFF)
|
||||
SELECT JSON_ARRAYAGG(('111' || i)::bytea FORMAT JSON NULL ON NULL RETURNING text) FILTER (WHERE i > 3)
|
||||
FROM generate_series(1,5) i;
|
||||
|
||||
EXPLAIN (VERBOSE, COSTS OFF)
|
||||
SELECT JSON_ARRAYAGG(('111' || i)::bytea FORMAT JSON NULL ON NULL RETURNING text) OVER (PARTITION BY i % 2)
|
||||
FROM generate_series(1,5) i;
|
||||
|
||||
CREATE VIEW json_arrayagg_view AS
|
||||
SELECT JSON_ARRAYAGG(('111' || i)::bytea FORMAT JSON NULL ON NULL RETURNING text) FILTER (WHERE i > 3)
|
||||
FROM generate_series(1,5) i;
|
||||
|
||||
\sv json_arrayagg_view
|
||||
|
||||
DROP VIEW json_arrayagg_view;
|
||||
|
||||
-- Test JSON_ARRAY(subquery) deparsing
|
||||
EXPLAIN (VERBOSE, COSTS OFF)
|
||||
SELECT JSON_ARRAY(SELECT i FROM (VALUES (1), (2), (NULL), (4)) foo(i) RETURNING jsonb);
|
||||
|
||||
CREATE VIEW json_array_subquery_view AS
|
||||
SELECT JSON_ARRAY(SELECT i FROM (VALUES (1), (2), (NULL), (4)) foo(i) RETURNING jsonb);
|
||||
|
||||
\sv json_array_subquery_view
|
||||
|
||||
DROP VIEW json_array_subquery_view;
|
||||
Reference in New Issue
Block a user