JSON_INSERT
説明
JSON_INSERT関数は、JSONにデータを挿入して結果を返すために使用されます。
構文
JSON_INSERT (<json_str>, <path>, <val>[, <path>, <val>, ...])
パラメータ
| パラメータ | 説明 |
|---|---|
<json_str> | 挿入されるJSONオブジェクト。NULL を含む任意の型の要素を持つJSONオブジェクトを指定できます。要素が指定されていない場合は、空の配列が返されます。json_str が有効なJSONでない場合、またはパスパラメータが有効なパス式でない場合や * ワイルドカードを含む場合は、エラーが返されます。 |
<path> | 挿入されるJSONパス。NULLの場合、NULLを返します。 |
<val> | JSONに挿入される値。NULLの場合、対応する位置にNULL値が挿入されます。 |
json_insert 関数はJSONにデータを挿入し、結果を返します。json_str または path がNULLの場合はNULLを返します。それ以外の場合、json_str 引数が有効なJSONでない場合、またはパス引数が有効なパス式でない場合や * ワイルドカードを含む場合はエラーが発生します。
パスと値のペアは左から右に評価されます。
jsonに存在しないパスのパスと値のペアは、パスが以下のタイプの値のいずれかを識別する場合、jsonに値を追加します：
-
既存のオブジェクトに存在しないメンバー。メンバーはオブジェクトに追加され、新しい値と関連付けられます。
-
既存の配列の末尾を超える位置。配列は新しい値で拡張されます。既存の値が配列でない場合は、配列として自動ラップされてから新しい値で拡張されます。
それ以外の場合、jsonに存在しないパスのパスと値のペアは無視され、効果はありません。
戻り値
JSON値を返します。
例
select json_insert(null, null, null);
+---------------------------------+
| json_insert(NULL, NULL, 'NULL') |
+---------------------------------+
| NULL |
+---------------------------------+
select json_insert('{"k": 1}', "$.k", 2);
+---------------------------------------+
| json_insert('{\"k\": 1}', '$.k', '2') |
+---------------------------------------+
| {"k":1} |
+---------------------------------------+
select json_insert('{"k": 1}', "$.j", 2);
+---------------------------------------+
| json_insert('{\"k\": 1}', '$.j', '2') |
+---------------------------------------+
| {"k":1,"j":2} |
+---------------------------------------+
select json_insert('{"k": 1}', "$.j", null);
+-----------------------------------------------+
| json_insert('{"k": 1}', '$.j', 'NULL', '660') |
+-----------------------------------------------+
| {"k":1,"j":null} |
+-----------------------------------------------+