Available in versions: Dev (3.21) | Latest (3.20) | 3.19 | 3.18 | 3.17 | 3.16 | 3.15 | 3.14 | 3.13 | 3.12
NULL ON NULL
Supported by ✅ Open Source Edition ✅ Express Edition ✅ Professional Edition ✅ Enterprise Edition
The JSON_OBJECT function has a NULL ON NULL clause to indicate that NULL values should be included in the output JSON document:
SELECT json_object( KEY 'cd' VALUE language.cd, KEY 'desc' VALUE language.description NULL ON NULL ) FROM language
create.select(jsonObject(
key("cd").value(LANGUAGE.CD),
key("desc").value(LANGUAGE.DESCRIPTION))
.nullOnNull())
.from(LANGUAGE)
.fetch();
The result would look like this:
+------------------------------+
| json_object |
+------------------------------+
| {"cd":"EN","desc":"English"} |
| {"cd":"DE","desc":null} |
+------------------------------+
Dialect support
This example using jOOQ:
jsonObject("description", LANGUAGE.DESCRIPTION).nullOnNull()
Translates to the following dialect specific expressions:
Aurora Postgres, CockroachDB, Postgres, YugabyteDB
json_build_object('description', LANGUAGE.DESCRIPTION)
BigQuery, DuckDB, MariaDB, MySQL, SQLite, Spanner
json_object('description', LANGUAGE.DESCRIPTION)
ClickHouse
toJSONString(map('description', LANGUAGE.DESCRIPTION))
DB2, H2, Oracle
json_object( KEY 'description' VALUE LANGUAGE.DESCRIPTION NULL ON NULL )
Snowflake
object_construct_keep_null('description', LANGUAGE.DESCRIPTION)
SQLServer
json_object( 'description': LANGUAGE.DESCRIPTION NULL ON NULL )
Trino
cast(
map_from_entries(ARRAY[row(
'description',
cast(LANGUAGE.DESCRIPTION AS json)
)])
AS json
)
ASE, Access, Aurora MySQL, Databricks, Exasol, Firebird, HSQLDB, Hana, Informix, MemSQL, Redshift, SQLDataWarehouse, Sybase, Teradata, Vertica
/* UNSUPPORTED */
Generated with jOOQ 3.21. Support in older jOOQ versions may differ. Translate your own SQL on our website
Feedback
Do you have any feedback about this page? We'd love to hear it!