MariaDB JSON_MERGE_PATCH() 函数的基础用法与实例

MariaDB JSON_MERGE_PATCH() 函数是一个用于合并两个或多个 JSON 文档的函数。它遵循 RFC 7396 的规范，用来替代已经弃用的 JSON_MERGE() 函数。该函数的合并逻辑是，如果两个 JSON 文档中有相同的键，那么后面的值会覆盖前面的值；如果后面的值是 NULL，那么相应的键会被删除；如果两个 JSON 文档不是同一种类型，那么后面的文档会替换前面的文档。该函数可以接受两个或多个参数，每个参数都是一个 JSON 文档，可以是一个 JSON 字符串，也可以是一个 JSON 列。该函数返回一个新的 JSON 文档，为合并后的结果。如果任意一个参数为 NULL，那么该函数会返回 NULL。

语法

MariaDB JSON_MERGE_PATCH() 函数的语法如下：

JSON_MERGE_PATCH(json_doc, json_doc[, json_doc] ...)

其中：

json_doc 是一个 JSON 文档，可以是一个 JSON 字符串，也可以是一个 JSON 列。

实例

下面是一些使用 MariaDB JSON_MERGE_PATCH() 函数的实例。

合并两个简单的 JSON 对象

假设我们有两个 JSON 对象，分别表示一个人的信息和一个人的地址：

SET @json1 = '{"name": "Alice", "age": 18}';
SET @json2 = '{"city": "Beijing", "country": "China"}';

我们可以使用 MariaDB JSON_MERGE_PATCH() 函数，将这两个 JSON 对象合并为一个 JSON 对象：

SELECT JSON_MERGE_PATCH(@json1, @json2) AS result;

运行结果如下：

+---------------------------------------------------------------------+
| result                                                              |
+---------------------------------------------------------------------+
| {"name": "Alice", "age": 18, "city": "Beijing", "country": "China"} |
+---------------------------------------------------------------------+

可以看到，合并后的 JSON 对象包含了两个 JSON 对象中的所有键和值。

合并两个有相同键的 JSON 对象

假设我们有两个 JSON 对象，分别表示一个人的信息和一个人的更新信息：

SET @json1 = '{"name": "Alice", "age": 18, "hobbies": ["reading", "music", "travel"]}';
SET @json2 = '{"name": "Bob", "age": 20, "hobbies": null}';

我们可以使用 MariaDB JSON_MERGE_PATCH() 函数，将这两个 JSON 对象合并为一个 JSON 对象：

SELECT JSON_MERGE_PATCH(@json1, @json2) AS result;

运行结果如下：

+----------------------------+
| result                     |
+----------------------------+
| {"name": "Bob", "age": 20} |
+----------------------------+

可以看到，合并后的 JSON 对象中，后面的值覆盖了前面的值，而且后面的值为 NULL 的键被删除了。

合并两个不同类型的 JSON 值

假设我们有两个不同类型的 JSON 值，一个是一个数组，一个是一个对象：

SET @json1 = '["apple", "banana", "cherry"]';
SET @json2 = '{"fruit": "orange"}';

我们可以使用 MariaDB JSON_MERGE_PATCH() 函数，将这两个 JSON 值合并为一个 JSON 值：

SELECT JSON_MERGE_PATCH(@json1, @json2) AS result;

运行结果如下：

+---------------------+
| result              |
+---------------------+
| {"fruit": "orange"} |
+---------------------+

可以看到，合并后的 JSON 值是后面的 JSON 值，而不是一个数组或对象。

合并多个 JSON 文档

假设我们有三个 JSON 文档，分别表示一个电影的信息，一个电影的评分，和一个电影的评论：

SET @json1 = '{"title": "The Matrix", "year": 1999}';
SET @json2 = '{"rating": 8.7, "genres": ["Action", "Sci-Fi", "Thriller"]}';
SET @json3 = '{"reviews": [{"user": "Alice", "comment": "Awesome movie!"}, {"user": "Bob", "comment": "Mind-blowing!"}]}';

我们可以使用 MariaDB JSON_MERGE_PATCH() 函数，将这三个 JSON 文档合并为一个 JSON 文档：

SELECT JSON_MERGE_PATCH(@json1, @json2, @json3) AS result;

运行结果如下：

{"title": "The Matrix", "year": 1999, "rating": 8.7, "genres": ["Action", "Sci-Fi", "Thriller"], "reviews": [{"user": "Alice", "comment": "Awesome movie!"}, {"user": "Bob", "comment": "Mind-blowing!"}]}

可以看到，合并后的 JSON 文档包含了三个 JSON 文档中的所有键和值。

语法

实例

合并两个简单的 JSON 对象

合并两个有相同键的 JSON 对象

合并两个不同类型的 JSON 值

合并多个 JSON 文档

总结