listagg必须显式指定within group(order by ...)，否则报ora-30488；默认varchar2(4000)超长抛ora-01489，需on overflow截断或转clob；不支持内置distinct，须子查询去重。
LISTAGG 基本用法和必须指定的 ORDER BY
Oracle 19c 中 LISTAGG 不允许省略 ORDER BY 子句，否则直接报错 ORA-30488: argument of LISTAGG must be ordered。这是和早期版本（如 11g）的关键区别，很多人迁移后卡在这一步。
正确写法必须显式声明排序依据：
SELECT deptno,
LISTAGG(ename, ', ') WITHIN GROUP (ORDER BY ename) AS emp_list
FROM emp
GROUP BY deptno;
-
WITHIN GROUP (ORDER BY ...)是强制语法结构，不能写成ORDER BY在外层 - 分隔符（如
', '）可以为空字符串''，但不建议——空分隔符易导致字段粘连难识别 - 如果排序字段含
NULL，默认排在最前；需要控制位置可加NULLS LAST或NULLS FIRST
处理超长结果：避免 ORA-01489 错误
LISTAGG 默认返回 VARCHAR2(4000)，一旦拼接结果超长就抛出 ORA-01489: result of string concatenation is too long。19c 提供了 ON OVERFLOW TRUNCATE 机制，但需主动启用。
两种安全写法：
-- 方案1：截断并加提示（推荐用于报表类场景） LISTAGG(ename, ', ') WITHIN GROUP (ORDER BY ename) ON OVERFLOW TRUNCATE '...' WITHOUT COUNT
-- 方案2：改用 CLOB 返回（适合后续还要处理的场景） LISTAGG(ename, ', ') WITHIN GROUP (ORDER BY ename) ON OVERFLOW TRUNCATE '' WITH COUNT
-
WITHOUT COUNT不显示截断长度，WITH COUNT会在末尾追加(n)表示被截掉的字符数 - 即使用了
ON OVERFLOW，函数返回类型仍取决于分隔符和表达式——若想稳定得 CLOB，可在外面套一层TO_CLOB() - 注意：
ON OVERFLOW仅在 12.2+ 有效，19c 完全支持，但老脚本迁移时容易漏加
去重拼接：LISTAGG 本身不支持 DISTINCT
LISTAGG 没有内置 DISTINCT 参数，直接写 LISTAGG(DISTINCT ename, ...) 会报错 ORA-30494: missing WITHIN GROUP clause 或语法错误。
实现去重拼接必须提前过滤：
SELECT deptno,
LISTAGG(ename, ', ') WITHIN GROUP (ORDER BY ename) AS emp_list
FROM (SELECT DISTINCT deptno, ename FROM emp)
GROUP BY deptno;
- 子查询去重是最稳妥方式；窗口函数或
ROW_NUMBER()也可行，但更重且易出错 - 如果去重逻辑复杂（比如按某字段优先级选唯一值），务必把去重逻辑放在内层查询，而不是靠外层
GROUP BY碰运气 - 注意：
DISTINCT作用于整行，若只希望对某一列去重但保留其他关联字段，需明确业务含义再设计子查询
替代方案：当 LISTAGG 不够用时考虑 JSON_OBJECTAGG
纯字符串拼接遇到结构化需求（比如要带键名、嵌套、自动转义特殊字符）时，LISTAGG 很快见顶。19c 的 JSON_OBJECTAGG 是更现代的选择。
SELECT deptno,
JSON_OBJECTAGG(ename VALUE job) AS emp_job_map
FROM emp
GROUP BY deptno;
- 结果是标准 JSON 字符串，天然支持键值对、自动处理引号和反斜杠
- 比手写
LISTAGG拼接更安全，尤其字段含逗号、换行、单引号时 - 缺点：返回类型为
CLOB，如果下游系统只认 VARCHAR2，还得转TO_CHAR()，且长度仍可能超限
拼接逻辑越简单，LISTAGG 越直接；一旦涉及格式、转义、嵌套，就该切换思路——不是函数不行，而是问题已超出它的设计边界。
