MySQL 8.4 Release Notes
14.17.1 JSON 函数参考
表14.22 JSON 函数
Name | Description | Deprecated |
---|---|---|
-> |
从 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 schema;返回 TRUE/1 如果文档验证通过 schema,否则返回 FALSE/0 | |
JSON_SCHEMA_VALIDATION_REPORT() |
将 JSON 文档验证对 JSON schema;返回验证结果报告在 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 值的“美化打印”,使用JSON_PRETTY()
函数。你可以查看给定的 JSON 值所占用的存储空间,以及剩余的存储空间,使用JSON_STORAGE_SIZE()
和 JSON_STORAGE_FREE()
,分别。要了解这些函数的完整描述,请参阅第 14.17.8 节,“JSON 实用函数”。