12.18.1 JSON函数参考

12.18.1 JSON函数参考

源文档路径：MySQL :: MySQL 5.7 Reference Manual :: 12.18.1 JSON Function Reference

JSON方法

名称	描述	发布版本	已弃用
->	返回在操作路径之后的JSON列的值；等同于JSON_EXTRACT()。
->>	返回操作路径之后的JSON列的值，结果去掉引号。等同于JSON_UNQUOTE(JSON_EXTRACT())。	5.7.13
JSON_APPEND()	在JSON文档后添加数据。		Yes
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()。浏览Section 12.20, “Aggregate Functions”来查看这些的描述。

以下也是从MySQL 5.7.22开始的：

• JSON值的”pretty-printing“以一种易读的格式，可以通过使用JSON_PRETTY()函数获取到。
• 通过使用JSON_STORAGE_SIZE()函数可以查看一个指定的JSON值占用多大的存储空间。

要查看这两个函数的完整描述，请浏览Section 12.18.6, “JSON Utility Functions”。