MariaDB JSON_OBJECTAGG() 函数使用指南

在 MariaDB 中，JSON_OBJECTAGG() 是一个内置函数，它将由第一个参数作为键和第二个参数作为值的键值对聚合为一个 JSON 对象。

MariaDB JSON_OBJECTAGG() 语法

这里是 MariaDB JSON_OBJECTAGG() 函数的语法：

JSON_OBJECTAGG(key_expr, value_expr)

我们通常在 MariaDB 中按如下方式使用 JSON_OBJECTAGG() 函数：

SELECT JSON_OBJECTAGG(key_expr, value_expr), ...
FROM table_name
[WHERE ...]
[GROUP BY group_expr1, group_expr2, ...];

参数

key_expr

必须的。它的值作为结果对象中的键值对中的键。它可以是一个列名，也可以是一个表达式。

value_expr

可选的。它的值作为结果对象中的键值对中的值。它可以是一个列名，也可以是一个表达式。

返回值

MariaDB JSON_OBJECTAGG() 函数返回一个 JSON 对象，其中的键值对中的键是 key_expr 的值，值是 value_expr 的值。

如果存在重复的键，则只保留最后一个键作为键值对，其他重复的键值对都被丢弃。

如果结果集没有任何行，此函数将返回 NULL。

MariaDB JSON_OBJECTAGG() 示例

我们将通过 student_score 表进行演示。

首先，让我们使用如下语句创建表 student_score：

DROP TABLE IF EXISTS `student_score`;
CREATE TABLE `student_score` (
    `id` INT PRIMARY KEY AUTO_INCREMENT,
    `name` VARCHAR(255) NOT NULL,
    `subject` VARCHAR(255) NOT NULL,
    `score` INT NOT NULL
);

这里我们创建了表用于存储学生的成绩，这个表有 4 个列组成：

• id 是主键
• name 是学生的名字
• subject 是学生的科目
• score 是学生的成绩

其次，让我插入一些数据用于演示：

INSERT INTO `student_score` (`name`, `subject`, `score`)
VALUES
    ('Tom', 'Math', 80),
    ('Tom', 'English', 90),
    ('Tim', 'English', 98);

以下是表中的数据：

+----+------+---------+-------+
| id | name | subject | score |
+----+------+---------+-------+
|  1 | Tom  | Math    |    80 |
|  2 | Tom  | English |    90 |
|  3 | Tim  | English |    98 |
+----+------+---------+-------+

基本示例

要获取一个包含了要将所有的科目和成绩 JSON 对象，请使用以下语句：

SELECT
    JSON_OBJECTAGG(subject, score) AS `Scores`
FROM student_score;

输出：

+-----------------------------------------+
| Scores                                  |
+-----------------------------------------+
| {"Math":80, "English":90, "English":98} |
+-----------------------------------------+

这显然没有太多的使用价值。通过分组您可以获得更精确的统计。

分组

通过分组，我们可以使用 JSON_OBJECTAGG() 函数获取每个人考试成绩，如下：

SELECT
    name AS `Name`,
    JSON_OBJECTAGG(subject, score) AS `Scores`
FROM student_score
GROUP BY name;

输出：

+------+-----------------------------+
| Name | Scores                      |
+------+-----------------------------+
| Tim  | {"English": 98}             |
| Tom  | {"Math": 80, "English": 90} |
+------+-----------------------------+

在本示例中，我们按照 name 分组。结果集中的 Scores 列的值是 JSON 对象。

对于 Tim 来说，由于他只参加了一门考试，因此 JSON 对象 {"English": 98} 中只有一个键值对。

对于 Tom 来说，由于他参加了两门考试，因此 JSON 对象 {"Math": 80, "English": 90} 中有两个键值对。

结论

在 MariaDB 中，JSON_OBJECTAGG() 是一个内置函数，它将由第一个参数作为键和第二个参数作为值的键值对聚合为一个 JSON 对象。