Available in versions: Dev (3.18)

This documentation is for the unreleased development version of jOOQ. Click on the above version links to get this documentation for a supported version of jOOQ.

JSON_REPLACE function

Applies to ✅ Open Source Edition   ✅ Express Edition   ✅ Professional Edition   ✅ Enterprise Edition

The MySQL style JSON_REPLACE function is a function that does not add add (like JSON_INSERT) but replaces a value in a JSON document, given a JSON path.

SELECT 
  JSON_REPLACE('{"a":1}', '$.a', 2),
  JSON_REPLACE('{"a":1}', '$.b', 2)
create.select(
           jsonReplace(val(json("{\"a\":1}")), "$.a", 2),
           jsonReplace(val(json("{\"a\":1}")), "$.b", 2)).fetch();

The result would look like this:

+--------------+--------------+
| json_replace | json_replace |
+--------------+--------------+
| {"a":2}      | {"a":1}      |
+--------------+--------------+

Dialect support

This example using jOOQ:

jsonReplace(val(json("{\"a\":1}")), "$.a", 2)

Translates to the following dialect specific expressions:

-- MARIADB, MYSQL, SQLITE
json_replace('{"a":1}', '$.a', 2)

-- ORACLE
json_transform('{"a":1}', REPLACE '$.a' = nvl(NULL, 2))

-- SQLSERVER
CASE
  WHEN coalesce(
    json_query('{"a":1}', '$.a'),
    json_value('{"a":1}', '$.a')
  ) IS NULL THEN '{"a":1}'
  ELSE json_modify(
    json_modify('{"a":1}', '$.a', ''),
    ('strict ' + '$.a'),
    2
  )
END

-- ACCESS, ASE, AURORA_MYSQL, AURORA_POSTGRES, BIGQUERY, COCKROACHDB, DB2, DERBY, EXASOL, FIREBIRD, H2, HANA, HSQLDB, 
-- INFORMIX, MEMSQL, POSTGRES, REDSHIFT, SNOWFLAKE, SQLDATAWAREHOUSE, SYBASE, TERADATA, VERTICA, YUGABYTEDB
/* UNSUPPORTED */

(These are currently generated with jOOQ 3.18, see #10141), or translate your own on our website

Feedback

Do you have any feedback about this page? We'd love to hear it!

The jOOQ Logo