SQL Server的PIVOT不支持变量列名，因IN子句仅接受静态标识符；须用STRING_AGG+QUOTENAME生成动态列字符串，再通过sp_executesql执行拼接的完整语句。
为什么直接写 PIVOT 无法用变量当列名
SQL Server 的 PIVOT 语法要求列名必须是静态字面量，不能是变量或表达式。如果你写了 FOR category IN (@cols)，会立刻报错：Must declare the scalar variable "@cols" 或更常见的 Incorrect syntax near '@cols'。这不是权限或版本问题，而是语法硬限制 —— PIVOT 的 IN 子句只接受逗号分隔的标识符列表，不支持运行时拼接。
用动态 SQL 拼出完整 PIVOT 语句
核心思路是：先查出要转成列的值（比如所有 product_name），拼成字符串 [iPhone], [Samsung S23], [Pixel 8]，再把这串塞进 PIVOT 的 IN 子句里，最后用 EXEC 或 sp_executesql 执行整条语句。
关键点：
- 用
STRING_AGG（SQL Server 2017+）或FOR XML PATH（旧版本）生成列名列表，每个值必须用方括号包裹，防止含空格或特殊字符 - 聚合函数（如
SUM）和PIVOT的聚合字段（如amount）必须明确指定，不能省略 - 务必用
sp_executesql而非EXEC()，便于参数化、防注入，也方便调试（可先PRINT @sql看生成的语句）
示例片段：
DECLARE @cols NVARCHAR(MAX), @sql NVARCHAR(MAX);
SELECT @cols = STRING_AGG(QUOTENAME(product_name), ', ')
FROM (SELECT DISTINCT product_name FROM sales) AS tmp;
<p>SET @sql = N'
SELECT * FROM (
SELECT region, product_name, amount FROM sales
) src
PIVOT (SUM(amount) FOR product_name IN (' + @cols + N')) AS pvt;';</p><p>EXEC sp_executesql @sql;列名太多或数据稀疏时的性能与结果处理
动态列数不可控时，PIVOT 返回的结果集结构每次可能不同，客户端代码（如 C#、Python）需按元数据读取列名，不能硬编码索引或字段名。
常见陷阱：
-
STRING_AGG默认长度上限是 4000 字符，列多时会截断 —— 必须显式声明NVARCHAR(MAX)接收变量 - 若源数据中
product_name为空或重复，QUOTENAME仍会生成合法列名（如[<NULL>]），但聚合结果可能不符合预期，建议提前WHERE product_name IS NOT NULL - 没有匹配列名的数据行，在
PIVOT后对应列为NULL，不是 0 —— 如需补零，得在外层SELECT中对每个动态列用ISNULL([col], 0)，但这又需要再次动态生成，复杂度陡增
替代方案：用条件聚合（CASE WHEN）是否更可控
如果只是少数几个固定业务维度（比如“Q1/Q2/Q3/Q4”或“线上/线下/代理”），优先用 CASE WHEN + MAX/SUM，不用动态 SQL，可读性高、执行计划稳定、调试方便。
例如：
SELECT region, SUM(CASE WHEN channel = 'online' THEN sales ELSE 0 END) AS online, SUM(CASE WHEN channel = 'offline' THEN sales ELSE 0 END) AS offline FROM sales GROUP BY region;
但它无法应对“每个用户自定义标签生成列”这类真正动态场景 —— 那一刻，你绕不开动态 SQL。
真正难的不是拼字符串，而是确保 @cols 来源数据稳定、去重干净，并且整个流程能被下游系统可靠消费。列名一旦带特殊字符或超长，QUOTENAME 能兜底；但语义错误（比如把时间戳当列名）只能靠上游逻辑控制。
