修改 JSON 值的 JSON 函数
本文档介绍用于修改 JSON 值的 JSON 函数。
JSON_APPEND()
该函数为 JSON_ARRAY_APPEND()
的别名。
JSON_ARRAY_APPEND()
JSON_ARRAY_APPEND(json_array, path, value [,path, value] ...)
函数将 value
插入 path
中指定的 json_array
数组的末尾,并返回结果。
该函数可接受成对的 path
和 value
参数。
示例:
下面示例向 JSON 文档根目录的数组添加了一个元素。
SELECT JSON_ARRAY_APPEND('["Car", "Boat", "Train"]', '$', "Airplane") AS "Transport options";
+--------------------------------------+
| Transport options |
+--------------------------------------+
| ["Car", "Boat", "Train", "Airplane"] |
+--------------------------------------+
1 row in set (0.00 sec)
下面的示例向指定路径下的数组添加了一个元素。
SELECT JSON_ARRAY_APPEND('{"transport_options": ["Car", "Boat", "Train"]}', '$.transport_options', "Airplane") AS "Transport options";
+-------------------------------------------------------------+
| Transport options |
+-------------------------------------------------------------+
| {"transport_options": ["Car", "Boat", "Train", "Airplane"]} |
+-------------------------------------------------------------+
1 row in set (0.00 sec)
JSON_ARRAY_INSERT()
JSON_ARRAY_INSERT(json_array, path, value [,path, value] ...)
函数将 value
插入 path
中 json_array
的指定位置,并返回结果。
该函数可接受成对的 path
和 value
参数。
示例:
下面的示例在数组中索引为 0 的位置插入了一个值。
SELECT JSON_ARRAY_INSERT('["Car", "Boat", "Train"]', '$[0]', "Airplane") AS "Transport options";
+--------------------------------------+
| Transport options |
+--------------------------------------+
| ["Airplane", "Car", "Boat", "Train"] |
+--------------------------------------+
1 row in set (0.01 sec)
下面的示例在数组中索引为 1 的位置插入了一个值。
SELECT JSON_ARRAY_INSERT('["Car", "Boat", "Train"]', '$[1]', "Airplane") AS "Transport options";
+--------------------------------------+
| Transport options |
+--------------------------------------+
| ["Car", "Airplane", "Boat", "Train"] |
+--------------------------------------+
1 row in set (0.00 sec)
JSON_INSERT()
JSON_INSERT(json_doc,path,value[,path,value] ...)
函数将一个或多个值插入到 JSON 文档,并返回结果。
该函数可接受成对的 path
和 value
参数。
SELECT JSON_INSERT(
'{"language": ["Go", "Rust", "C++"]}',
'$.architecture', 'riscv',
'$.os', JSON_ARRAY("linux","freebsd")
) AS "Demo";
+------------------------------------------------------------------------------------------+
| Demo |
+------------------------------------------------------------------------------------------+
| {"architecture": "riscv", "language": ["Go", "Rust", "C++"], "os": ["linux", "freebsd"]} |
+------------------------------------------------------------------------------------------+
1 row in set (0.00 sec)
请注意,该函数不会覆盖现有属性。例如,以下语句看起来会覆盖 "a"
属性现有的值,但实际上并不会。
SELECT JSON_INSERT('{"a": 61, "b": 62}', '$.a', 41, '$.c', 63);
+---------------------------------------------------------+
| JSON_INSERT('{"a": 61, "b": 62}', '$.a', 41, '$.c', 63) |
+---------------------------------------------------------+
| {"a": 61, "b": 62, "c": 63} |
+---------------------------------------------------------+
1 row in set (0.00 sec)
JSON_MERGE_PATCH()
JSON_MERGE_PATCH(json_doc, json_doc [,json_doc] ...)
将两个或多个 JSON 文档合并为一个 JSON 文档,但不保留重复键的值。如果其中某些 json_doc
参数包含重复的键,合并后的结果只保留后面指定的那个 json_doc
参数中的值。
示例:
在下面的示例中,可以看到合并结果中 a
的值被第二个参数覆盖,而 c
被添加为一个新属性。
SELECT JSON_MERGE_PATCH(
'{"a": 1, "b": 2}',
'{"a": 100}',
'{"c": 300}'
);
+-----------------------------------------------------------------+
| JSON_MERGE_PATCH('{"a": 1, "b": 2}','{"a": 100}', '{"c": 300}') |
+-----------------------------------------------------------------+
| {"a": 100, "b": 2, "c": 300} |
+-----------------------------------------------------------------+
1 row in set (0.00 sec)
JSON_MERGE_PRESERVE()
JSON_MERGE_PRESERVE(json_doc, json_doc [,json_doc] ...)
函数通过保留所有键值的方式合并两个或多个 JSON 文档,并返回合并结果。
示例:
在下面的示例中,可以看到第二个参数的值被附加到了 a
中,并且 c
被添加为一个新属性。
SELECT JSON_MERGE_PRESERVE('{"a": 1, "b": 2}','{"a": 100}', '{"c": 300}');
+--------------------------------------------------------------------+
| JSON_MERGE_PRESERVE('{"a": 1, "b": 2}','{"a": 100}', '{"c": 300}') |
+--------------------------------------------------------------------+
| {"a": [1, 100], "b": 2, "c": 300} |
+--------------------------------------------------------------------+
1 row in set (0.00 sec)
JSON_MERGE()
该函数为 JSON_MERGE_PRESERVE()
已废弃的别名。
JSON_REMOVE()
JSON_REMOVE(json_doc,path [,path] ...)
函数从 JSON 文档中删除指定 path
的数据并返回结果。
示例:
下面示例删除了 JSON 文档中的 b
属性。
SELECT JSON_REMOVE('{"a": 61, "b": 62, "c": 63}','$.b');
+--------------------------------------------------+
| JSON_REMOVE('{"a": 61, "b": 62, "c": 63}','$.b') |
+--------------------------------------------------+
| {"a": 61, "c": 63} |
+--------------------------------------------------+
1 row in set (0.00 sec)
下面示例删除了 JSON 文档中的 b
和 c
属性。
SELECT JSON_REMOVE('{"a": 61, "b": 62, "c": 63}','$.b','$.c');
+--------------------------------------------------------+
| JSON_REMOVE('{"a": 61, "b": 62, "c": 63}','$.b','$.c') |
+--------------------------------------------------------+
| {"a": 61} |
+--------------------------------------------------------+
1 row in set (0.00 sec)
JSON_REPLACE()
JSON_REPLACE(json_doc,path,value[,path,value]...)
函数替换 JSON 文档中的现有的值并返回结果。如果指定的路径不存在,该路径对应的值不会添加到结果中。
该函数可接受成对的 path
和 value
参数。
示例:
下面的示例将 $.b
的值从 62
替换为 42
。
SELECT JSON_REPLACE('{"a": 41, "b": 62}','$.b',42);
+---------------------------------------------+
| JSON_REPLACE('{"a": 41, "b": 62}','$.b',42) |
+---------------------------------------------+
| {"a": 41, "b": 42} |
+---------------------------------------------+
1 row in set (0.00 sec)
下面的示例将 $.b
的值从 62
替换为 42
。此外,该语句试图用 43
替换 $.c
中的值,但不会替换成功,因为在 {"a": 41, "b": 62}
中 $.c
路径不存在。
SELECT JSON_REPLACE('{"a": 41, "b": 62}','$.b',42,'$.c',43);
+------------------------------------------------------+
| JSON_REPLACE('{"a": 41, "b": 62}','$.b',42,'$.c',43) |
+------------------------------------------------------+
| {"a": 41, "b": 42} |
+------------------------------------------------------+
1 row in set (0.00 sec)
JSON_SET()
JSON_SET(json_doc,path,value[,path,value] ...)
函数在 JSON 文档中插入或更新数据,并返回结果。
该函数可接受成对的 path
和 value
参数。
示例:
下面的示例将 $.version
从 1.1
更新为 1.2
。
SELECT JSON_SET('{"version": 1.1, "name": "example"}','$.version',1.2);
+-----------------------------------------------------------------+
| JSON_SET('{"version": 1.1, "name": "example"}','$.version',1.2) |
+-----------------------------------------------------------------+
| {"name": "example", "version": 1.2} |
+-----------------------------------------------------------------+
1 row in set (0.00 sec)
下面的示例将 $.version
从 1.1
更新为 1.2
,并将之前不存在的 $.branch
更新为 main
。
SELECT JSON_SET('{"version": 1.1, "name": "example"}','$.version',1.2,'$.branch', "main");
+------------------------------------------------------------------------------------+
| JSON_SET('{"version": 1.1, "name": "example"}','$.version',1.2,'$.branch', "main") |
+------------------------------------------------------------------------------------+
| {"branch": "main", "name": "example", "version": 1.2} |
+------------------------------------------------------------------------------------+
1 row in set (0.00 sec)
JSON_UNQUOTE()
JSON_UNQUOTE(json)
函数去掉 JSON 值的引号,并以字符串形式返回结果。该函数与 JSON_QUOTE()
函数作用相反。
示例:
下面示例将 "foo"
去掉引号,变成 foo
。
SELECT JSON_UNQUOTE('"foo"');
+-----------------------+
| JSON_UNQUOTE('"foo"') |
+-----------------------+
| foo |
+-----------------------+
1 row in set (0.00 sec)
该函数通常与 JSON_EXTRACT()
一起使用。在下面的示例中,第一个示例提取带引号的 JSON 值,第二个示例通过将两个函数结合使用去掉提取值的引号。请注意,你可以使用 ->>
操作符来代替 JSON_UNQUOTE(JSON_EXTRACT(...))
。
SELECT JSON_EXTRACT('{"database": "TiDB"}', '$.database');
+----------------------------------------------------+
| JSON_EXTRACT('{"database": "TiDB"}', '$.database') |
+----------------------------------------------------+
| "TiDB" |
+----------------------------------------------------+
1 row in set (0.00 sec)
SELECT JSON_UNQUOTE(JSON_EXTRACT('{"database": "TiDB"}', '$.database'));
+------------------------------------------------------------------+
| JSON_UNQUOTE(JSON_EXTRACT('{"database": "TiDB"}', '$.database')) |
+------------------------------------------------------------------+
| TiDB |
+------------------------------------------------------------------+
1 row in set (0.00 sec)