JSON_REPLACE

説明

JSON_REPLACE関数は、JSON内のデータを更新し、結果を返すために使用されます。

構文

JSON_REPLACE (<json_str>, <path>, <val>[, <jsonPath>, <val>, ...])

パラメータ

パラメータ	説明
<json_str>	置換されるJSONデータ。NULL を含む任意の型の要素を持つJSONオブジェクトにできます。要素が指定されない場合、空の配列が返されます。json_str が有効なJSONでない場合、エラーが返されます。
<path>	置換されるJSONパス。
<val>	JSON_PATHキーに対応する値を置換する値。NULLの場合、対応する位置にNULL値が挿入されます。

戻り値

json_replace 関数はJSON内のデータを更新し、結果を返します。json_str または path がNULLの場合、NULLを返します。それ以外の場合、json_str 引数が有効なJSONでないか、いずれかのpath引数が有効なパス式でないか * ワイルドカードを含む場合、エラーが発生します。

パス-値のペアは左から右に評価されます。

json内の既存のパスに対するパス-値のペアは、既存のjson値を新しい値で上書きします。

それ以外の場合、json内の存在しないパスに対するパス-値のペアは無視され、効果はありません。

例

select json_replace(null, null, null);

+----------------------------------+
| json_replace(NULL, NULL, 'NULL') |
+----------------------------------+
| NULL                             |
+----------------------------------+

select json_replace('{"k": 1}', "$.k", 2);

+----------------------------------------+
| json_replace('{\"k\": 1}', '$.k', '2') |
+----------------------------------------+
| {"k":2}                                |
+----------------------------------------+

select json_replace('{"k": 1}', "$.j", 2);

+----------------------------------------+
| json_replace('{\"k\": 1}', '$.j', '2') |
+----------------------------------------+
| {"k":1}                                |
+----------------------------------------+

select json_replace(null, null, 's');

+--------------------------------------+
| json_replace(NULL, NULL, 's', '006') |
+--------------------------------------+
| NULL                                 |
+--------------------------------------+