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

MariaDB JSON_ARRAY_APPEND() 函数是一个用于向 JSON 数组中追加元素的函数。它可以接受多个参数，每个参数都是一个键值对，表示要追加的位置和值。该函数返回一个新的 JSON 数组，包含了追加后的元素。如果参数中的位置不是一个有效的 JSON 数组，或者值不是一个有效的 JSON 值，那么该函数会返回 NULL。

语法

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

JSON_ARRAY_APPEND(json_doc, path, val[, path, val] ...)

其中：

json_doc 是一个 JSON 文档，可以是一个 JSON 字符串，也可以是一个 JSON 列。
path 是一个 JSON 路径，用于指定要追加元素的位置。它必须以 $ 开头，表示 JSON 文档的根。它可以使用点号 . 或方括号 [] 来访问 JSON 对象的属性或 JSON 数组的元素。它还可以使用通配符 * 来匹配所有的属性或元素。如果路径不存在，那么该函数会返回 NULL。
val 是一个 JSON 值，可以是一个基本类型（如字符串，数字，布尔值，NULL），也可以是一个复合类型（如对象，数组）。它表示要追加到 JSON 数组中的值。

实例

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

向一个简单的 JSON 数组追加一个元素

假设我们有一个 JSON 文档，表示一个水果的列表：

SET @json = '["apple", "banana", "cherry"]';

我们可以使用 MariaDB JSON_ARRAY_APPEND() 函数，向这个 JSON 数组的末尾追加一个元素，比如 "durian"：

SELECT JSON_ARRAY_APPEND(@json, '$', 'durian') AS result;

运行结果如下：

["apple", "banana", "cherry", "durian"]

向一个嵌套的 JSON 数组追加一个元素

假设我们有一个 JSON 文档，表示一个学生的信息：

SET @json = '{"name": "Alice", "age": 18, "courses": ["Math", "English", "History"]}';

我们可以使用 MariaDB JSON_ARRAY_APPEND() 函数，向这个 JSON 文档中的 courses 数组追加一个元素，比如 "Science"：

SELECT JSON_ARRAY_APPEND(@json, '$.courses', 'Science') AS result;

运行结果如下：

{"name": "Alice", "age": 18, "courses": ["Math", "English", "History", "Science"]}

向一个 JSON 数组的指定位置追加一个元素

假设我们有一个 JSON 文档，表示一个图书馆的藏书：

SET @json = '[{"title": "The Catcher in the Rye", "author": "J.D. Salinger"}, {"title": "Nineteen Eighty-Four", "author": "George Orwell"}]';

我们可以使用 MariaDB JSON_ARRAY_APPEND() 函数，向这个 JSON 数组的第一个元素（即第一本书）的末尾追加一个属性，比如 "year": 1951：

SELECT JSON_ARRAY_APPEND(@json, '$[0]', '{"year": 1951}') AS result;

运行结果如下：

[[{"title": "The Catcher in the Rye", "author": "J.D. Salinger"}, "{\"year\": 1951}"], {"title": "Nineteen Eighty-Four", "author": "George Orwell"}]

向一个 JSON 数组的多个位置追加多个元素

假设我们有一个 JSON 文档，表示一个电影的评分：

SET @json = '{"title": "The Matrix", "rating": 8.7, "genres": ["Action", "Sci-Fi"]}';

我们可以使用 MariaDB JSON_ARRAY_APPEND() 函数，向这个 JSON 文档中的 genres 数组和根对象分别追加一个元素，比如 "Thriller" 和 "year": 1999：

SELECT JSON_ARRAY_APPEND(@json, '$.genres', 'Thriller', '$', '{"year": 1999}') AS result;

运行结果如下：

[{"title": "The Matrix", "rating": 8.7, "genres": ["Action", "Sci-Fi", "Thriller"]}, "{\"year\": 1999}"]

向一个不存在的 JSON 数组追加一个元素

假设我们有一个 JSON 文档，表示一个人的信息：

SET @json = '{"name": "Bob", "age": 25}';

我们可以使用 MariaDB JSON_ARRAY_APPEND() 函数，尝试向这个 JSON 文档中的 hobbies 数组追加一个元素，比如 "reading"：

SELECT JSON_ARRAY_APPEND(@json, '$.hobbies', 'reading') AS result;

运行结果如下：

+--------+
| result |
+--------+
| NULL   |
+--------+

这是因为 hobbies 数组不存在，所以该函数返回 NULL。

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

语法

实例

向一个简单的 JSON 数组追加一个元素

向一个嵌套的 JSON 数组追加一个元素

向一个 JSON 数组的指定位置追加一个元素

向一个 JSON 数组的多个位置追加多个元素

向一个不存在的 JSON 数组追加一个元素

相关函数

结论