pgsql: SQL/JSON: Document behavior when input document is not jsonb

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

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/473a352fb393519f22cd4d31839ad3d74b1aeea1

Modified Files
--------------
doc/src/sgml/func.sgml | 10 ++++++++++
1 file changed, 10 insertions(+)