MySQL :: MySQL 8.4 参考手册 :: 14.17.1 JSON 函数参考

版本 8.4

8.0 日语

MySQL 8.4 参考手册 / ... / JSON 函数参考

14.17.1 JSON 函数参考

表 14.22 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()`	比较两个 JSON 文档，如果它们有任何共同的键值对或数组元素，则返回 TRUE (1)，否则返回 FALSE (0)
`JSON_PRETTY()`	以人类可读的格式打印 JSON 文档
`JSON_QUOTE()`	引用 JSON 文档
`JSON_REMOVE()`	从 JSON 文档中删除数据
`JSON_REPLACE()`	替换 JSON 文档中的值
`JSON_SCHEMA_VALID()`	根据 JSON 模式验证 JSON 文档；如果文档通过模式验证，则返回 TRUE/1，否则返回 FALSE/0
`JSON_SCHEMA_VALIDATION_REPORT()`	根据 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 值是否有效
`JSON_VALUE()`	从 JSON 文档中提取路径指向位置的值；将此值作为 VARCHAR(512) 或指定类型返回
`MEMBER OF()`	如果第一个操作数与作为第二个操作数传递的 JSON 数组的任何元素匹配，则返回 true (1)，否则返回 false (0)

MySQL 支持两个聚合 JSON 函数 JSON_ARRAYAGG() 和 JSON_OBJECTAGG()。有关这些函数的说明，请参阅第 14.19 节，“聚合函数”。

MySQL 还支持使用 JSON_PRETTY() 函数以易于阅读的格式对 JSON 值进行“格式化打印”。您可以使用 JSON_STORAGE_SIZE() 和 JSON_STORAGE_FREE() 分别查看给定 JSON 值占用的存储空间以及剩余的可用存储空间。有关这些函数的完整说明，请参阅第 14.17.8 节，“JSON 工具函数”。