Document strange jsonb sort order for empty top level arrays
authorAndrew Dunstan <[email protected]>
Fri, 3 Jan 2025 14:23:46 +0000 (09:23 -0500)
committerAndrew Dunstan <[email protected]>
Fri, 3 Jan 2025 15:29:18 +0000 (10:29 -0500)
commit20a344bce8949f542eb25360fe69f14aa9a05b1b
treea420628cef45dafff3821a2ca5e8627005a76d0d
parent73055a2bb170c0eb738d88c22ad51b662788236d
Document strange jsonb sort order for empty top level arrays

Slightly faulty logic in the original jsonb code (commit d9134d0a355)
results in an empty top level array sorting less than a json null. We
can't change the sort order now since it would affect btree indexes over
jsonb, so document the anomaly.

Backpatch to all live branches (13 .. 17)

In master, also add a code comment noting the anomaly.

Reported-by: Yan Chengpen
Reviewed-by: Jian He
Discussion: https://postgr.es/m/OSBPR01MB45199DD8DA2D1CECD50518188E272@OSBPR01MB4519.jpnprd01.prod.outlook.com
doc/src/sgml/json.sgml