SQL/JSON: Document behavior when input document is not jsonb
authorAmit Langote
Fri, 28 Jun 2024 00:42:13 +0000 (09:42 +0900)
committerAmit Langote
Fri, 28 Jun 2024 00:45:03 +0000 (09:45 +0900)
commit473a352fb393519f22cd4d31839ad3d74b1aeea1
tree1aa69e5491908f57a16efcca04a1e078d8435a0e
parent5d6c64d290978dab76c00460ba809156874be035
SQL/JSON: Document behavior when input document is not jsonb

The input document to functions JSON_EXISTS(), JSON_QUERY(),
JSON_VALUE(), and JSON_TABLE() can be specified as character or
UTF8-encoded bytea strings. These are automatically converted to
jsonb with an implicit cast before being passed to the jsonpath
machinery.

In the current implementation, errors that occur when parsing the
specified string into a valid JSON document are thrown
unconditionally. This means they are not subject to the explicit or
implicit ON ERROR clause of those functions, which is a standard-
conforming behavior.  Add a note to the documentation to mention
that.

Reported-by: Markus Winand
Discussion: https://postgr.es/m/F7DD1442-265C-4220-A603-CB0DEB77E91D%40winand.at
doc/src/sgml/func.sgml