大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:group_concat

· 52CE 我爱测

将分组中的多个非 NULL 值连接成一个字符串,参数 为字符串之间的连接符,该参数可选,默认为 。该函数在连接时会忽略 NULL 值。

group_concat

将分组中的多个非 NULL 值连接成一个字符串,参数 sep 为字符串之间的连接符,该参数可选,默认为 ,。该函数在连接时会忽略 NULL 值。

从 3.0.6,3.1.3 版本开始,group_concat 支持使用 DISTINCT 和 ORDER BY。

语法

VARCHAR GROUP_CONCAT([DISTINCT] expr [,expr ...]
             [ORDER BY {unsigned_integer | col_name | expr}
                 [ASC | DESC] [,col_name ...]]
             [SEPARATOR sep])

参数说明

  • expr: 待拼接的值,支持的数据类型为 VARCHAR。可以指定 DISTINCT 关键字在连接之前移除分组中的重复值。如果想直接连接多个值,可以使用 concat 和 concat_ws 来指定连接的方式。
  • ORDER BY 后可以跟 unsigned_integer (从 1 开始)、列名、或普通表达式。ORDER BY 用于指定按升序或降序对要连接的值进行排序。默认按升序排序。如果要按降序排序,需要指定 DESC。
  • sep:字符串之间的连接符,可选。如果不指定,则默认使用逗号 , 作为连接符。如果要使用空字符来连接,可以使用 ''。

NOTE

从 v3.0.6 和 v3.1.3 版本起,分隔符必须使用 SEPARATOR 关键字来声明。 举例,select group_concat(name SEPARATOR '-') as res from ss;。

返回值说明

返回值的数据类型为 VARCHAR。如果没有非 NULL 值,则返回 NULL。

您可以使用系统变量 group_concat_max_len 来控制可以返回的最大字符长度。默认值:1024。最小值:4。单位:字符。

变量的设置方法:

SET [GLOBAL | SESSION] group_concat_max_len = <value>

示例

  1. 建表并插入数据。

    CREATE TABLE `ss` (
      `id` int(11) NULL COMMENT "",
      `name` varchar(255) NULL COMMENT "",
      `subject` varchar(255) NULL COMMENT "",
      `score` int(11) NULL COMMENT ""
    ) ENGINE=OLAP
    DUPLICATE KEY(`id`)
    DISTRIBUTED BY HASH(`id`) BUCKETS 4
    PROPERTIES (
    "replication_num" = "1"
    );
    
    insert into ss values (1,"Tom","English",90);
    insert into ss values (1,"Tom","Math",80);
    insert into ss values (2,"Tom","English",NULL);
    insert into ss values (2,"Tom",NULL,NULL);
    insert into ss values (3,"May",NULL,NULL);
    insert into ss values (3,"Ti","English",98);
    insert into ss values (4,NULL,NULL,NULL);
    insert into ss values (NULL,"Ti","Phy",98);
    
    select * from ss order by id;
    +------+------+---------+-------+
    | id   | name | subject | score |
    +------+------+---------+-------+
    | NULL | Ti   | Phy     |    98 |
    |    1 | Tom  | English |    90 |
    |    1 | Tom  | Math    |    80 |
    |    2 | Tom  | English |  NULL |
    |    2 | Tom  | NULL    |  NULL |
    |    3 | May  | NULL    |  NULL |
    |    3 | Ti   | English |    98 |
    |    4 | NULL | NULL    |  NULL |
    +------+------+---------+-------+
    
  2. 使用 group_concat 对值进行拼接。

    示例一:对 name 列的值进行拼接,使用默认连接符,忽略 NULL 值。不对数据进行去重。

    select group_concat(name) as res from ss;
    +---------------------------+
    | res                       |
    +---------------------------+
    | Tom,Tom,Ti,Tom,Tom,May,Ti |
    +---------------------------+
    

    示例二:对 name 列的值进行拼接,使用 SEPARATOR 来声明分隔符 -,忽略 NULL 值。不对数据进行去重。

    select group_concat(name SEPARATOR '-') as res from ss;
    +---------------------------+
    | res                       |
    +---------------------------+
    | Ti-May-Ti-Tom-Tom-Tom-Tom |
    +---------------------------+
    

    示例三:对 name 列的值进行拼接,使用默认连接符,忽略 NULL 值。使用 DISTINCT 对数据进行去重。

    select group_concat(distinct name) as res from ss;
    +---------------------------+
    | res                       |
    +---------------------------+
    | Ti,May,Tom                |
    +---------------------------+
    

    示例四:将相同 ID 的 name 和 subject 组合按照 score 的升序进行连接。比如返回示例中的第二行数据 TomMath,TomEnglish 就是将 ID 为 1 的 TomMath and TomEnglish 组合按照 score 进行升序排序。

    select id, group_concat(distinct name,subject order by score) as res from ss group by id order by id;
    +------+--------------------+
    | id   | res                |
    +------+--------------------+
    | NULL | TiPhy              |
    |    1 | TomMath,TomEnglish |
    |    2 | TomEnglish         |
    |    3 | TiEnglish          |
    |    4 | NULL               |
    +------+--------------------+
    

    示例五:在 group_concat 中嵌套 concat 函数。concat 指定 name 和 subject 的连接格式为 "name-subject"。查询逻辑和示例三相同。

    select id, group_concat(distinct concat(name,'-',subject) order by score) as res from ss group by id order by id;
    +------+----------------------+
    | id   | res                  |
    +------+----------------------+
    | NULL | Ti-Phy               |
    |    1 | Tom-Math,Tom-English |
    |    2 | Tom-English          |
    |    3 | Ti-English           |
    |    4 | NULL                 |
    +------+----------------------+
    

    示例六:没有符合条件的结果,返回 NULL。

    select group_concat(distinct name) as res from ss where id < 0;
    +------+
    | res  |
    +------+
    | NULL |
    +------+
    

    示例七:将返回字符串的最大长度限制在 6 个字符。查询逻辑和示例三相同。

    set group_concat_max_len = 6;
    
    select id, group_concat(distinct name,subject order by score) as res from ss group by id order by id;
    +------+--------+
    | id   | res    |
    +------+--------+
    | NULL | TiPhy  |
    |    1 | TomMat |
    |    2 | NULL   |
    |    3 | TiEngl |
    |    4 | NULL   |
    +------+--------+
    

keywords

GROUP_CONCAT,CONCAT,ARRAY_AGG

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。