【MySQL】MySQL中的函数之JSON_ARRAY_APPEND

在 MySQL 8.0 及更高版本中,JSON_ARRAY_APPEND() 函数用于在 JSON 数组的指定位置追加一个或多个值。这个函数非常有用,特别是在你需要在 JSON 数组的末尾或特定位置添加新的元素时。

基本语法

sql 复制代码
JSON_ARRAY_APPEND(json_doc, path, val[, path, val] ...)
  • json_doc: 要修改的 JSON 文档。
  • path: 要追加值的路径。路径必须指向一个数组。
  • val: 要追加的新值。

示例

假设有一个表 users,其中有一个字段 data 存储了用户的 JSON 数据:

sql 复制代码
CREATE TABLE users (
    id INT PRIMARY KEY,
    data JSON
);

INSERT INTO users (id, data) VALUES
(1, '{"name": "Alice", "age": 30, "hobbies": ["reading", "traveling"]}'),
(2, '{"name": "Bob", "age": 25, "hobbies": ["gaming", "coding"]}');
示例 1: 向 JSON 数组中追加一个值

假设我们要向 id 为 1 的用户的 hobbies 数组中追加一个新的爱好 "cooking":

sql 复制代码
UPDATE users
SET data = JSON_ARRAY_APPEND(data, '$.hobbies', 'cooking')
WHERE id = 1;

查询结果:

sql 复制代码
SELECT * FROM users;

输出结果:

复制代码
+----+------------------------------------------------------------+
| id | data                                                       |
+----+------------------------------------------------------------+
| 1  | {"name": "Alice", "age": 30, "hobbies": ["reading", "traveling", "cooking"]} |
| 2  | {"name": "Bob", "age": 25, "hobbies": ["gaming", "coding"]}                             |
+----+------------------------------------------------------------+
示例 2: 向 JSON 数组中追加多个值

假设我们要向 id 为 2 的用户的 hobbies 数组中追加两个新的爱好 "painting" 和 "music":

sql 复制代码
UPDATE users
SET data = JSON_ARRAY_APPEND(data, '$.hobbies', 'painting', '$.hobbies', 'music')
WHERE id = 2;

查询结果:

sql 复制代码
SELECT * FROM users;

输出结果:

复制代码
+----+------------------------------------------------------------------+
| id | data                                                             |
+----+------------------------------------------------------------------+
| 1  | {"name": "Alice", "age": 30, "hobbies": ["reading", "traveling", "cooking"]} |
| 2  | {"name": "Bob", "age": 25, "hobbies": ["gaming", "coding", "painting", "music"]} |
+----+------------------------------------------------------------------+
示例 3: 向嵌套的 JSON 数组中追加值

假设 JSON 数据中包含嵌套的数组:

sql 复制代码
INSERT INTO users (id, data) VALUES
(3, '{"name": "Charlie", "age": 35, "projects": [{"name": "Project A", "tasks": ["task1", "task2"]}, {"name": "Project B", "tasks": ["task3", "task4"]}] }');

我们可以向 id 为 3 的用户的 projects 数组中的第一个项目的 tasks 数组中追加一个新的任务 "task5":

sql 复制代码
UPDATE users
SET data = JSON_ARRAY_APPEND(data, '$.projects[0].tasks', 'task5')
WHERE id = 3;

查询结果:

sql 复制代码
SELECT * FROM users;

输出结果:

复制代码
+----+-------------------------------------------------------------------------------------------------------------------------+
| id | data                                                                                                                    |
+----+-------------------------------------------------------------------------------------------------------------------------+
| 1  | {"name": "Alice", "age": 30, "hobbies": ["reading", "traveling", "cooking"]}                                            |
| 2  | {"name": "Bob", "age": 25, "hobbies": ["gaming", "coding", "painting", "music"]}                                       |
| 3  | {"name": "Charlie", "age": 35, "projects": [{"name": "Project A", "tasks": ["task1", "task2", "task5"]}, {"name": "Project B", "tasks": ["task3", "task4"]}] } |
+----+-------------------------------------------------------------------------------------------------------------------------+

注意事项

  • JSON_ARRAY_APPEND() 只能在 JSON 数组的末尾追加值。如果路径指向的不是数组,JSON_ARRAY_APPEND() 将返回 NULL
  • 如果路径不存在,JSON_ARRAY_APPEND() 也不会修改 JSON 文档。
  • 如果需要在数组的特定位置插入值,可以使用 JSON_INSERT()JSON_SET() 函数。

组合使用

JSON_ARRAY_APPEND() 通常与其他 JSON 函数结合使用,以便更灵活地处理 JSON 数据。例如,你可以先使用 JSON_EXTRACT() 提取值,然后使用 JSON_ARRAY_APPEND() 修改值。

相关推荐
为美好的生活献上中指3 分钟前
java每日精进 4.29【框架之自动记录日志并插入如数据库流程分析】
java·linux·数据库
极小狐1 小时前
如何创建极狐GitLab 私密议题?
数据库·ci/cd·gitlab·devops·mcp
像风一样自由20202 小时前
PySide与PyQt对比:为何PySide是更优选择
数据库·系统架构·pyqt
HashData酷克数据2 小时前
回顾|Apache Cloudberry™ (Incubating) Meetup·2025 杭州站
数据库
未来的JAVA高级开发工程师2 小时前
悲观锁与乐观锁
java·数据库
A charmer2 小时前
【MySQL】库的操作
数据库·mysql
Mr.Demo.2 小时前
[MySQL数据库] InnoDB存储引擎(四): InnoDB磁盘文件
数据库·mysql
maomi_95262 小时前
MySQL 在 CentOS 7 环境下的安装教程
大数据·数据库·mysql
书山有鹿3 小时前
PostgreSQL psql 命令和常用的 SQL 语句整理
数据库·sql·postgresql