MySQL JSON数据类型详解与高效操作指南

1. MySQL JSON数据类型基础解析

JSON（JavaScript Object Notation）作为现代Web应用中广泛使用的轻量级数据交换格式，MySQL从5.7版本开始原生支持JSON数据类型。这种支持不仅仅是简单的字符串存储，而是真正实现了JSON文档的解析、验证和高效访问。

在实际项目中，我经常遇到需要存储非结构化或半结构化数据的场景。传统的解决方案是使用TEXT类型存储JSON字符串，然后在应用层解析，这种方式存在几个明显缺陷：

• 无法保证存储内容的JSON格式有效性
• 修改任何字段都需要读取完整文档
• 缺乏原生的查询优化能力

MySQL的JSON类型完美解决了这些问题。创建包含JSON字段的表非常简单：

sql复制CREATE TABLE products (
    id INT AUTO_INCREMENT PRIMARY KEY,
    attributes JSON NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

重要提示：JSON列不能有默认值（MySQL 8.0.13之前），也不能直接创建普通索引。这是新手常踩的坑，我们会在后续章节详细讨论索引方案。

2. JSON函数操作全指南

2.1 创建JSON文档

MySQL提供了多种创建JSON文档的函数：

sql复制-- 创建JSON对象
SELECT JSON_OBJECT('name', 'iPhone', 'price', 6999, 'colors', JSON_ARRAY('black', 'white'));

-- 创建JSON数组
SELECT JSON_ARRAY(1, 'a', TRUE, NULL, JSON_OBJECT('key', 'value'));

-- 从字符串转换
SELECT CAST('{"key": "value"}' AS JSON);

我在实际使用中发现，JSON_OBJECT在MySQL 5.7和8.0版本有行为差异：

sql复制-- MySQL 5.7会保留第一个出现的key
SELECT JSON_OBJECT('key', 1, 'key', 2); 
-- 结果: {"key": 1}

-- MySQL 8.0会保留最后出现的key
SELECT JSON_OBJECT('key', 1, 'key', 2);
-- 结果: {"key": 2}

2.2 查询与提取数据

JSON数据的提取是日常开发中最常用的操作，MySQL提供了丰富的路径表达式语法：

sql复制-- 提取对象属性
SELECT JSON_EXTRACT('{"name": "John", "age": 30}', '$.name');

-- 提取数组元素
SELECT JSON_EXTRACT('[10, 20, [30, 40]]', '$[2][1]');

-- 简化的箭头语法
SELECT attributes->'$.price' FROM products;

-- 去除引号的提取
SELECT attributes->>'$.name' FROM users;

路径表达式支持多种高级特性：

• $[*] 匹配所有数组元素
• $[1 to 3] 范围选择
• $**.key 递归搜索所有层级
• $.key1.key2 嵌套访问

2.3 修改JSON文档

MySQL提供了三种修改JSON文档的函数，它们的区别我通过下表说明：

实际示例：

sql复制SET @json = '{"a": 1, "b": 2}';

-- 混合操作
SELECT JSON_SET(@json, '$.a', 10, '$.c', 3);
-- 结果: {"a": 10, "b": 2, "c": 3}

-- 仅插入新值
SELECT JSON_INSERT(@json, '$.a', 10, '$.c', 3);
-- 结果: {"a": 1, "b": 2, "c": 3}

-- 仅替换存在值
SELECT JSON_REPLACE(@json, '$.a', 10, '$.c', 3);
-- 结果: {"a": 10, "b": 2}

2.4 删除元素

JSON_REMOVE函数可以删除指定路径的元素：

sql复制SET @json = '{"a": 1, "b": [2, 3], "c": {"d": 4}}';

-- 删除对象属性
SELECT JSON_REMOVE(@json, '$.a');
-- 结果: {"b": [2, 3], "c": {"d": 4}}

-- 删除数组元素
SELECT JSON_REMOVE('["a", "b", "c"]', '$[1]');
-- 结果: ["a", "c"]

-- 多路径删除
SELECT JSON_REMOVE(@json, '$.a', '$.c.d');
-- 结果: {"b": [2, 3]}

3. JSON性能优化实践

3.1 索引策略

由于JSON列不能直接创建索引，我们需要使用生成列+索引的方案：

sql复制CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    profile JSON,
    -- 虚拟列提取用户名
    username VARCHAR(50) AS (profile->>'$.username'),
    -- 虚拟列提取年龄并建立索引
    age INT AS (profile->'$.age'),
    INDEX idx_age (age),
    INDEX idx_username (username)
);

这种方案有几个关键点：

1. 虚拟列可以使用STORED关键字物化存储
2. 提取的标量值才能建立索引
3. 查询时必须使用相同的表达式才能命中索引

3.2 局部更新优化

MySQL 8.0引入了Partial Updates特性，可以原地更新JSON文档而非整个替换。要启用此优化需满足：

1. 使用JSON_SET/JSON_REPLACE/JSON_REMOVE函数
2. 更新前后文档大小不增加
3. 输入输出是同一列

通过以下函数可以监控空间使用：

sql复制SELECT 
    JSON_STORAGE_SIZE(attributes) AS total_size,
    JSON_STORAGE_FREE(attributes) AS free_size 
FROM products;

3.3 数据类型转换

JSON与其他类型的转换需要注意：

sql复制-- 字符串转JSON
SELECT CAST('{"key": "value"}' AS JSON);

-- JSON转字符串
SELECT JSON_UNQUOTE(JSON_EXTRACT('{"name": "John"}', '$.name'));

-- 提取特定类型
SELECT 
    attributes->'$.price' AS price_json,
    CAST(attributes->'$.price' AS DECIMAL(10,2)) AS price_value
FROM products;

4. 高级JSON函数与应用

4.1 条件查询函数

sql复制-- 检查包含关系
SELECT JSON_CONTAINS('[1, 2, 3]', '2');  -- 返回1

-- 检查路径存在
SELECT JSON_CONTAINS_PATH('{"a": 1}', 'one', '$.a', '$.b');  -- 返回1

-- 值是否存在数组中
SELECT 2 MEMBER OF('[1, 2, 3]');  -- 返回1

4.2 聚合函数

sql复制-- 将查询结果转为JSON对象
SELECT JSON_OBJECTAGG(username, score) FROM players;

-- 将列值聚合为JSON数组
SELECT JSON_ARRAYAGG(product_name) FROM products;

4.3 JSON表格化

JSON_TABLE函数可以将JSON数组展开为关系表：

sql复制SELECT * FROM JSON_TABLE(
    '[{"id":1,"name":"John"},{"id":2,"name":"Jane"}]',
    '$[*]' COLUMNS (
        id INT PATH '$.id',
        name VARCHAR(50) PATH '$.name'
    )
) AS jt;

5. 实战经验与避坑指南

5.1 常见问题排查

1. 无效JSON文档：使用JSON_VALID函数验证

   sql复制SELECT * FROM logs WHERE JSON_VALID(content) = 0;
   

2. 性能问题：大文档更新可能导致性能下降，考虑拆分为多个字段

3. 字符集问题：JSON文档默认使用utf8mb4字符集

5.2 设计建议

1. 适度使用：不是所有场景都需要JSON，结构化数据仍应使用传统列

2. 文档大小：单个JSON文档不宜过大（建议<1MB）

3. 查询模式：频繁查询的字段应提取为虚拟列并建立索引

5.3 版本差异

1. MySQL 5.7 vs 8.0的功能差异：

   • Partial Updates仅8.0支持
   • JSON_TABLE仅8.0支持
   • JSON_MERGE在8.0中被废弃

2. 升级注意事项：

   sql复制-- 检查不兼容的JSON文档
   SELECT * FROM table WHERE JSON_VALID(json_column) = 0;
   

6. JSON与其他数据类型的交互

6.1 与传统表结构转换

将JSON数组转为多行记录：

sql复制SELECT 
    t.id,
    jt.item
FROM orders t,
     JSON_TABLE(
         t.items,
         '$[*]' COLUMNS (
             item VARCHAR(100) PATH '$'
         )
     ) AS jt;

6.2 与字符串函数的结合

sql复制-- JSON字符串拼接
SELECT CONCAT('{"id":', id, '}') FROM users;

-- JSON与LIKE查询结合
SELECT * FROM products 
WHERE attributes->>'$.name' LIKE '%手机%';

7. 性能对比测试

我针对不同操作进行了基准测试（测试环境：MySQL 8.0.27，10万条记录）：

测试结果表明，合理使用JSON特性可以获得接近传统列的性能。