JSON函数参考

表 JSON函数

名称	描述
`->`	评估路径后从JSON列返回值；等效于JSON_EXTRACT（）。
`->>`	评估路径并取消引用结果后，从JSON列返回值；等效于JSON_UNQUOTE（JSON_EXTRACT（））。
`JSON_ARRAY()`	创建JSON数组
`JSON_ARRAY_APPEND()`	将数据附加到JSON文档
`JSON_ARRAY_INSERT()`	插入JSON数组
`JSON_CONTAINS()`	JSON文档是否在路径中包含特定对象
`JSON_CONTAINS_PATH()`	JSON文档是否在路径中包含任何数据
`JSON_DEPTH()`	JSON文档的最大深度
`JSON_EXTRACT()`	从JSON文档返回数据
`JSON_INSERT()`	将数据插入JSON文档
`JSON_KEYS()`	JSON文档中的键数组
`JSON_LENGTH()`	JSON文档中的元素数
`JSON_MERGE()`（已弃用）	合并JSON文档，保留重复的键。JSON_MERGE_PRESERVE（）的已弃用同义词
`JSON_MERGE_PATCH()`	合并JSON文档，替换重复键的值
`JSON_MERGE_PRESERVE()`	合并JSON文档，保留重复的键
`JSON_OBJECT()`	创建JSON对象
`JSON_OVERLAPS()`（引入8.0.17）	比较两个JSON文档，如果它们具有相同的键值对或数组元素，则返回TRUE（1），否则返回FALSE（0）
`JSON_PRETTY()`	以易于阅读的格式打印JSON文档
`JSON_QUOTE()`	引用JSON文档
`JSON_REMOVE()`	从JSON文档中删除数据
`JSON_REPLACE()`	替换JSON文档中的值
`JSON_SCHEMA_VALID()`（引入8.0.17）	根据JSON模式验证JSON文档；如果文档针对架构进行验证，则返回TRUE / 1；否则，则返回FALSE / 0
`JSON_SCHEMA_VALIDATION_REPORT()`（引入8.0.17）	根据JSON模式验证JSON文档；以JSON格式返回有关验证结果的报告，包括成功或失败以及失败原因
`JSON_SEARCH()`	JSON文档中值的路径
`JSON_SET()`	将数据插入JSON文档
`JSON_STORAGE_FREE()`	部分更新后，JSON列值的二进制表示形式中的可用空间
`JSON_STORAGE_SIZE()`	用于存储JSON文档的二进制表示的空间
`JSON_TABLE()`	从JSON表达式返回数据作为关系表
`JSON_TYPE()`	JSON值类型
`JSON_UNQUOTE()`	取消引用JSON值
`JSON_VALID()`	JSON值是否有效
`MEMBER OF()`（引入8.0.17）	如果第一个操作数与作为第二个操作数传递的JSON数组的任何元素匹配，则返回true（1），否则返回false（0）

MySQL支持两个聚合JSON函数JSON_ARRAYAGG()和JSON_OBJECTAGG()。有关这些功能的说明，请参见“聚合函数（GROUP BY）”。

MySQL还使用该功能以易于读取的格式支持JSON值的“漂亮打印”JSON_PRETTY()。您可以分别使用JSON_STORAGE_SIZE()和来参见给定JSON值占用了多少存储空间，以及还有多少空间可用于其他存储JSON_STORAGE_FREE()。有关这些功能的完整说明，请参见“ JSON实用程序功能”。