1
0
mirror of https://github.com/postgres/postgres.git synced 2026-10-23 13:29:09 +03:00

Doc: improve documentation of the JSON object aggregates.

Say which value wins for a repeated key, and how skipped null values
interact with that and with the unique check.  Also point out that
duplicate keys behave differently for json and jsonb cases.  (I still
think that's a bug, but at least now it's documented.)

Author: shihao zhong <zhong950419@gmail.com>
Reviewed-by: Tom Lane <tgl@sss.pgh.pa.us>
Discussion: https://postgr.es/m/CAGRkXqTCfSu=aEUCvKDTGroEWOcyz3MCv4Xi8x1PZ1T1rEmG=Q@mail.gmail.com
Backpatch-through: 14
This commit is contained in:
Tom Lane
2026-10-14 14:00:30 -04:00
parent 0a6dc4fe18
commit 2ad0b0f8c1

View File

@@ -19999,7 +19999,10 @@ SELECT NULLIF(value, '(none)') ...
Collects all the key/value pairs into a JSON object. Key arguments
are coerced to text; value arguments are converted as
per <function>to_json</function> or <function>to_jsonb</function>.
Values can be null, but not keys.
Values can be null, but keys cannot.
If a key appears more than once, the <type>json</type> result keeps
every pair, while the <type>jsonb</type> result keeps only the last
value for that key.
</para></entry>
<entry>No</entry>
</row>