MySQL 9.0 发行说明
表 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 工具函数”。