STRING_AGG在SQL Server中最低要求2017版本(含Azure SQL Database),2016及更早版本不支持,调用会报错“Invalid object name 'STRING_AGG'”;必须指定表达式和非空分隔符,排序须用WITHIN GROUP(ORDER BY ...)显式声明,NULL值自动忽略。

STRING_AGG 在 SQL Server 中的最低版本要求
SQL Server 2017(含 Azure SQL Database)才开始支持 STRING_AGG,低于这个版本会直接报错:Invalid object name 'STRING_AGG'。如果你用的是 SQL Server 2016 或更早,不能靠升级兼容级别解决——函数本身不存在,必须改用 FOR XML PATH('') 或 CLR 聚合等替代方案。
基本语法与分隔符处理
STRING_AGG 必须指定两个参数:待聚合的表达式和分隔符,且分隔符不能为空(传入 NULL 会导致整个结果为 NULL)。常见误写是漏掉逗号或把空字符串当分隔符:
SELECT STRING_AGG(name) -- ❌ 缺少分隔符,语法错误 SELECT STRING_AGG(name, '') -- ❌ 分隔符为空字符串,报错 SELECT STRING_AGG(name, ', ') -- ✅ 正确
- 分隔符可以是任意字符串,比如
'; '、CHAR(10)(换行) - 如果想在结果前后加括号,得用外层
CONCAT或字符串拼接:CONCAT('(', STRING_AGG(name, ', '), ')') - 聚合字段为
NULL时会被自动忽略,不会产生额外的分隔符
排序控制必须显式使用 WITHIN GROUP
STRING_AGG 默认不保证顺序,即使源数据有 ORDER BY 也不生效。必须用 WITHIN GROUP (ORDER BY ...) 子句声明排序逻辑,否则每次执行结果可能不一致:
SELECT STRING_AGG(name, ', ') FROM users ORDER BY created_date; -- ❌ ORDER BY 在外层,不影响聚合顺序 <p>SELECT STRING_AGG(name, ', ') WITHIN GROUP (ORDER BY created_date) FROM users; -- ✅ 正确</p>
-
WITHIN GROUP中支持多列排序,如ORDER BY status DESC, id ASC - 排序字段不必出现在
SELECT列表中,但必须在当前作用域可访问(比如不能引用子查询别名) - 若排序字段含
NULL,默认按NULLS LAST处理(SQL Server 不支持显式写NULLS FIRST/LAST)
处理大文本和性能注意事项
STRING_AGG 返回类型是 varchar(max) 或 nvarchar(max),取决于输入字段类型。但实际长度受内存和查询超时限制,不是无上限:
- 单次聚合结果超过 2GB 会失败(虽罕见,但在日志拼接、大批量 ID 合并时可能触发)
- 若被聚合列含大量长文本,性能明显下降;建议先用
WHERE过滤或TOP限制行数 - 无法直接在
GROUP BY查询中对同一字段既聚合又单独引用,需用子查询或 CTE 拆开 - 在视图或内联表值函数中使用时,注意客户端工具(如 SSMS)对超长结果的截断显示——实际数据完整,只是没全展示
跨多表 JOIN 后聚合容易因笛卡尔积导致重复拼接,务必确认 GROUP BY 键是否足够精确,或者先用派生表去重再聚合。










