listagg必须指定分隔符和order by排序，否则报ora-30496；超长触发ora-01489，12cr2+支持on overflow truncate，去重需子查询前置处理。
LISTAGG 基本用法：必须指定分隔符和排序依据
Oracle 的 LISTAGG 不是简单拼接，它强制要求提供排序逻辑（WITHIN GROUP (ORDER BY ...)），否则会报错 ORA-30497: Argument should be a constant or a function of expressions in the GROUP BY clause。不写 ORDER BY 会直接失败，不是可选项。
常见误写：LISTAGG(name) → 错误；正确写法必须带排序：LISTAGG(name, ',') WITHIN GROUP (ORDER BY name)。
- 分隔符可以是任意字符串，包括空格、分号、甚至
' → '，但不能是 NULL（否则整个结果变 NULL） - 排序字段不必是被聚合的列，比如按
hire_date排序合并employee_name完全合法 - 若排序字段含 NULL，默认排在最前（Oracle 12c+ 可加
NULLS LAST控制）
处理超长结果：避免 ORA-01489 错误
LISTAGG 默认返回 VARCHAR2(4000)，一旦拼接后超长，就会触发 ORA-01489: result of string concatenation is too long。这不是数据问题，是类型限制。
解决方式只有两个：
- 用
ON OVERFLOW TRUNCATE（Oracle 12cR2+）：例如LISTAGG(name, ',' ON OVERFLOW TRUNCATE '...' WITH COUNT) WITHIN GROUP (ORDER BY name)，注意必须显式写WITH COUNT才能显示截断计数 - 降级兼容方案：外层套
CAST(... AS CLOB)，如CAST(LISTAGG(name, ',') WITHIN GROUP (ORDER BY name) AS CLOB)，但要注意某些客户端（如旧版 SQL*Plus）对 CLOB 显示不友好
去重合并：LISTAGG 本身不支持 DISTINCT，得绕行
LISTAGG 没有内置 DISTINCT 参数，直接对重复值聚合会保留所有副本。想实现“去重后拼接”，不能靠函数参数，得靠前置处理。
典型做法是先用子查询或 CTE 去重：
SELECT dept_id,
LISTAGG(emp_name, ',') WITHIN GROUP (ORDER BY emp_name) AS names
FROM (SELECT DISTINCT dept_id, emp_name FROM employees)
GROUP BY dept_id;
注意：如果去重逻辑复杂（比如按最新记录取名），就把 DISTINCT 换成 ROW_NUMBER() 或 KEEP (DENSE_RANK FIRST...) 配合子查询。
替代方案对比：XMLAGG 和 MATCH_RECOGNIZE 适用场景
当 LISTAGG 被限制（如老版本 Oracle 11g）、或需要更灵活的拼接逻辑（如条件跳过某值），可考虑替代方案：
-
XMLAGG+XMLELEMENT：兼容 10g+，天然支持 CLOB，无 4000 字符限制，但语法啰嗦，且结果带 XML 标签需用EXTRACTVALUE或XMLCAST清洗 -
MATCH_RECOGNIZE（12c+）：适合需要“按业务规则分组拼接”的场景，比如只合并连续相同状态的记录，但学习成本高，小需求没必要上 - 纯 PL/SQL 自定义函数：可控性强，但失去 SQL 优化器路径，大数据量时性能明显下降
真正该换方案，往往不是因为功能不够，而是卡在版本或超长截断策略不满足业务要求——先确认是不是非得动底层逻辑。
