12.17.1 JSON 函数参考
table12.21 JSON 函数
| Name | Description |
|---|---|
| -> | 评估路径后从 JSON 列返回值；等效于 JSON_EXTRACT()。 |
| ->>(引入 5.7.13) | 评估路径并取消引用结果后，从 JSON 列返回值；等效于 JSON_UNQUOTE(JSON_EXTRACT())。 |
| JSON_APPEND() (deprecated) | 将数据附加到 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()(不建议使用 5.7.22) | 合并 JSON 文档，保留重复的键。 JSON_MERGE_PRESERVE()的已弃用同义词 |
| JSON_MERGE_PATCH()(引入 5.7.22) | 合并 JSON 文档，替换重复键的值 |
| JSON_MERGE_PRESERVE()(引入 5.7.22) | 合并 JSON 文档，保留重复的键 |
| JSON_OBJECT() | 创建 JSON 对象 |
| JSON_PRETTY()(引入 5.7.22) | 以易于阅读的格式打印 JSON 文档 |
| JSON_QUOTE() | 引用 JSON 文档 |
| JSON_REMOVE() | 从 JSON 文档中删除数据 |
| JSON_REPLACE() | 替换 JSON 文档中的值 |
| JSON_SEARCH() | JSON 文档中值的路径 |
| JSON_SET() | 将数据插入 JSON 文档 |
| JSON_STORAGE_SIZE()(引入 5.7.22) | 用于存储 JSON 文档的二进制 table 示形式的空间 |
| 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_STORAGE_SIZE()查看给定 JSON 值占用了多少存储空间。
有关这两个功能的完整说明，请参见第 12.17.6 节“ JSONUtil 函数”。
