Documentation Home

12.18.1 JSON函数参考

表 12.22 JSON 函数

姓名 描述 介绍 弃用
-> 评估路径后从 JSON 列返回值;相当于 JSON_EXTRACT()。
->> 在评估路径并取消引用结果后从 JSON 列返回值;相当于 JSON_UNQUOTE(JSON_EXTRACT())。 5.7.13
JSON_APPEND() 将数据附加到 JSON 文档 是的
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() 的弃用同义词 5.7.22
JSON_MERGE_PATCH() 合并 JSON 文档,替换重复键的值 5.7.22
JSON_MERGE_PRESERVE() 合并 JSON 文档,保留重复键 5.7.22
JSON_OBJECT() 创建 JSON 对象
JSON_PRETTY() 以人类可读的格式打印 JSON 文档 5.7.22
JSON_QUOTE() 引用 JSON 文档
JSON_REMOVE() 从 JSON 文档中删除数据
JSON_REPLACE() 替换 JSON 文档中的值
JSON_SEARCH() JSON 文档中的值路径
JSON_SET() 向 JSON 文档中插入数据
JSON_STORAGE_SIZE() 用于存储 JSON 文档的二进制表示的空间 5.7.22
JSON_TYPE() JSON 值的类型
JSON_UNQUOTE() 取消引用 JSON 值
JSON_VALID() JSON值是否有效

MySQL 5.7.22 及更高版本支持两个聚合 JSON 函数 JSON_ARRAYAGG()JSON_OBJECTAGG(). 有关这些的描述,请参阅 第 12.20 节,“聚合函数”

同样从 MySQL 5.7.22 开始:

  • 可以使用该 JSON_PRETTY()函数 以易于阅读的格式漂亮地打印” JSON 值。

  • 您可以使用查看给定 JSON 值占用多少存储空间JSON_STORAGE_SIZE()

有关这两个函数的完整描述,请参阅 第 12.18.6 节,“JSON 实用函数”