Document strange jsonb sort order for empty top level arrays
authorAndrew Dunstan <andrew@dunslane.net>
Fri, 3 Jan 2025 14:23:46 +0000 (09:23 -0500)
committerAndrew Dunstan <andrew@dunslane.net>
Fri, 3 Jan 2025 15:29:07 +0000 (10:29 -0500)
commitbd606ed8ec65f7ad388c3dead9ba200bf0b4fa6a
treeefde198a136129ff95ba0676050ef7caa078a02c
parent24a1948ad2b3a9a6730bb1f084891d8d2be85fea
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