MariaDB JSON_DETAILED() 函数使用指南
在 MariaDB 中,JSON_DETAILED()
是一个内置函数,它格式化输出一个 JSON 文档,以便更易于阅读。
MariaDB JSON_DETAILED()
函数与 MySQL JSON_PRETTY()
类似。
JSON_COMPACT()
与该函数相反,它从 JSON 文档删除不必要的空格和换行。
MariaDB JSON_DETAILED()
语法
这里是 MariaDB JSON_DETAILED()
函数的语法:
JSON_DETAILED(json)
JSON_DETAILED(json, tab_size)
参数
json
- 必需的。需要被处理的 JSON 文档。
tab_size
- 可选的。它指定制表符/缩进大小。
如果您提供了错误数量的参数,MariaDB 将报告一个错误: ERROR 1582 (42000): Incorrect parameter count in the call to native function 'JSON_DETAILED'
。
返回值
MariaDB JSON_DETAILED()
函数从给定的 JSON 文档中删除指定的空格。
如果您提供一个 NULL
值作为参数, JSON_DETAILED()
将返回 NULL
。
MariaDB JSON_DETAILED()
示例
下面的示例展示了 MariaDB JSON_DETAILED()
函数的用法。
基本示例
SET @json_doc = '{"x":1,"b": [2, 3]}';
SELECT JSON_DETAILED(@json_doc);
输出:
+------------------------------------------------------------+
| JSON_DETAILED(@json_doc) |
+------------------------------------------------------------+
| {
"x": 1,
"b":
[
2,
3
]
} |
+------------------------------------------------------------+
缩进大小
MariaDB JSON_DETAILED()
函数允许您使用 tab_size
参数改变缩进的大小:
SET @json_doc = '{"x":1,"b": [2, 3]}';
SELECT JSON_DETAILED(@json_doc, 1);
输出:
+------------------------------------+
| JSON_DETAILED(@json_doc, 1) |
+------------------------------------+
| {
"x": 1,
"b":
[
2,
3
]
} |
+------------------------------------+
NULL 参数
如果您提供一个 NULL
值作为参数, JSON_DETAILED()
将返回 NULL
。
SELECT JSON_DETAILED(NULL);
输出:
+---------------------+
| JSON_DETAILED(NULL) |
+---------------------+
| NULL |
+---------------------+
结论
在 MariaDB 中,JSON_DETAILED()
是一个内置函数,它格式化输出一个 JSON 文档,以便更易于阅读。