MariaDB JSON_DETAILED() 函数的基础用法与实例

MariaDB JSON_DETAILED() 函数是一个用于格式化输出一个 JSON 文档的函数。它可以使 JSON 文档更易于阅读，突出显示嵌套的结构。该函数可以接受一个或两个参数，分别表示一个 JSON 文档，和一个可选的制表符大小。该函数返回一个新的 JSON 文档，添加了适当的空格，换行，制表符等空白字符。如果参数不是一个有效的 JSON 文档，那么该函数会返回 NULL。

语法

MariaDB JSON_DETAILED() 函数的语法如下：

JSON_DETAILED(json_doc[, tab_size])

其中：

json_doc 是一个 JSON 文档，可以是一个 JSON 字符串，也可以是一个 JSON 列。
tab_size 是一个可选的整数，表示制表符的大小。默认值是 4。

实例

下面是一些使用 MariaDB JSON_DETAILED() 函数的实例。

格式化输出一个简单的 JSON 文档

假设我们有一个 JSON 文档，表示一个人的信息：

SET @json = '{"name": "Alice", "age": 18, "hobbies": ["reading", "music", "travel"]}';

我们可以使用 MariaDB JSON_DETAILED() 函数，格式化输出这个 JSON 文档，使其更易于阅读：

SELECT JSON_DETAILED(@json) AS result;

运行结果如下：

{
    "name": "Alice",
    "age": 18,
    "hobbies":
    [
        "reading",
        "music",
        "travel"
    ]
}

格式化输出一个嵌套的 JSON 文档

假设我们有一个 JSON 文档，表示一个图书馆的藏书：

SET @json = '[{"title": "The Catcher in the Rye", "author": "J.D. Salinger", "year": 1951}, {"title": "Nineteen Eighty-Four", "author": "George Orwell", "year": 1949}]';

我们可以使用 MariaDB JSON_DETAILED() 函数，格式化输出这个 JSON 文档，使其更易于阅读：

SELECT JSON_DETAILED(@json) AS result;

运行结果如下：

[
    {
        "title": "The Catcher in the Rye",
        "author": "J.D. Salinger",
        "year": 1951
    },
    {
        "title": "Nineteen Eighty-Four",
        "author": "George Orwell",
        "year": 1949
    }
]

指定制表符大小

MariaDB JSON_DETAILED() 函数允许我们使用 tab_size 参数指定制表符的大小，以改变输出的缩进：

假设我们有一个 JSON 文档，表示一个电影的评分：

SET @json = '{"title": "The Matrix", "rating": 8.7, "genres": ["Action", "Sci-Fi", "Thriller"], "year": 1999}';

我们可以使用 MariaDB JSON_DETAILED() 函数，指定制表符大小为 2，格式化输出这个 JSON 文档，使其更易于阅读：

SELECT JSON_DETAILED(@json, 2) AS result;

运行结果如下：

{
  "title": "The Matrix",
  "rating": 8.7,
  "genres":
  [
    "Action",
    "Sci-Fi",
    "Thriller"
  ],
  "year": 1999
}

MariaDB JSON_DETAILED() 函数的基础用法与实例

语法

实例

格式化输出一个简单的 JSON 文档

格式化输出一个嵌套的 JSON 文档

指定制表符大小

相关函数

结论