Oracle 中类似 MySQL GROUP_CONCAT 的实现：LISTAGG 函数详解与溢出处理

在 MySQL 中，我们要将同一个分组内的多行文本按逗号拼接成一行，可以使用非常方便的 GROUP_CONCAT() 函数。 而在 Oracle 数据库中，对应的核心函数是 LISTAGG()。

从 Oracle 11g Release 2 开始，Oracle 官方引入了原生的 LISTAGG() 函数，并在此后的 12c 和 19c 版本中不断增强其去重与超长溢出处理能力。

本文将为您全面拆解 LISTAGG() 的完整语法、常见用法以及避开最让人头痛的 ORA-01489 字符串溢出陷阱。

一、 LISTAGG() 基本语法剖析

LISTAGG(measure_expr [, 'delimiter'])
  WITHIN GROUP (ORDER BY sort_order)
  [OVER (PARTITION BY partition_cols)]

关键要素说明：

1. measure_expr：要拼接的目标列或表达式（例如员工姓名 emp_name）；
2. 'delimiter'：分隔符，可选，默认为空。通常设置为 ', ' 或 '; '；
3. WITHIN GROUP (ORDER BY ...)：必需子句！ 这是与 MySQL GROUP_CONCAT 最大的区别，Oracle 要求显式指定组内拼接时的排序规则。

二、 基础实战演练

假设我们有一张员工表 emp：

+--------+----------+---------+
| EMPNO  | ENAME    | DEPTNO  |
+--------+----------+---------+
|   7369 | SMITH    |      20 |
|   7499 | ALLEN    |      30 |
|   7521 | WARD     |      30 |
|   7566 | JONES    |      20 |
|   7654 | MARTIN   |      30 |
|   7698 | BLAKE    |      30 |
|   7782 | CLARK    |      10 |
|   7788 | SCOTT    |      20 |
|   7839 | KING     |      10 |
+--------+----------+---------+

需求：按部门分组，将每个部门下的所有员工姓名拼成一行

SELECT 
    deptno,
    LISTAGG(ename, ', ') WITHIN GROUP (ORDER BY ename) AS employees
FROM emp
GROUP BY deptno
ORDER BY deptno;

输出结果：

DEPTNO | EMPLOYEES
-------+------------------------------------------
    10 | CLARK, KING
    20 | JONES, SCOTT, SMITH
    30 | ALLEN, BLAKE, MARTIN, WARD

所有员工姓名整齐地按字母顺序排序，并以逗号分隔聚合在了一起。

三、 高阶特性一：在拼接中去除重复项 (DISTINCT)

从 Oracle 19c 开始，LISTAGG 原生支持了 DISTINCT 关键字：

SELECT 
    deptno,
    LISTAGG(DISTINCT job, ', ') WITHIN GROUP (ORDER BY job) AS distinct_jobs
FROM emp
GROUP BY deptno;

[!TIP] 如果你的数据库版本是 Oracle 11g 或 12c（低于 19c），LISTAGG 还不支持 DISTINCT 语法，可以通过在内层先执行 SELECT DISTINCT deptno, job FROM emp 子查询去重后再进行外层聚合。

四、 核心痛点：彻底解决 ORA-01489 字符串超长溢出

在生产环境中，如果某一个分组内的数据量极大，拼接后的总文本长度超过了 Oracle VARCHAR2 的最大限制（在未开启扩展数据类型时为 4,000 字节，开启后为 32,767 字节），系统会直接崩溃并抛出：

ORA-01489: result of string concatenation is too long

终极解法：使用 ON OVERFLOW TRUNCATE 截断保护 (Oracle 12.2+)

从 Oracle 12c Release 2 (12.2) 开始，官方专门为 LISTAGG 增加了优雅的溢出保护语法：

SELECT 
    deptno,
    LISTAGG(ename, ', ' ON OVERFLOW TRUNCATE '...' WITH COUNT) 
        WITHIN GROUP (ORDER BY ename) AS employees
FROM huge_table
GROUP BY deptno;

效果说明：

• 当文本达到 4,000 字节上限时，Oracle 会自动截断并在末尾追加指定的提示符 '...'；
• WITH COUNT 还会贴心地附带未展示的条数统计，例如：SMITH, JONES, ... (523)，代表还有 523 项被截断，既保护了 SQL 绝不报错，又清晰告知了读者数据总量！

五、 MySQL 与 Oracle 字符串聚合全景对比