UNPIVOT必须显式列出所有源列且拼写严格一致，不支持*通配；列名含空格需用方括号包裹；值类型不统一时需提前CAST；INSERT时须匹配目标表字段顺序、类型及约束；NULL值默认被丢弃，保留需预处理或改用CROSS APPLY。
UNPIVOT 语法必须显式列出源列，不能用 * 通配
UNPIVOT 不支持 SELECT * 或动态列名，所有要“融化”的列必须手写进 IN 子句。漏写一列，数据就丢；多写一个不存在的列，直接报错 Invalid column name。
常见错误是把原表中带空格或特殊字符的列名直接写进去，结果触发语法错误——这时必须用方括号包裹：[Sales Q1] 而不是 Sales Q1。
实操建议：
- 先用
SELECT TOP 1 *查看原表结构，确认列名和数据类型 - 把待转换的列（如
Q1,Q2,Q3,Q4）逐个列在IN里，顺序不重要，但拼写必须完全一致 - 如果列值类型不统一（比如有的是
INT，有的是DECIMAL(10,2)），UNPIVOT 会隐式转成兼容类型，可能截断小数位——建议提前用CAST或CONVERT统一转成目标类型
INSERT INTO ... SELECT 必须匹配目标表字段顺序和类型
UNPIVOT 后的结果集是两列：一个是新生成的类别名（如 Quarter），一个是值列（如 SalesAmount）。往目标表插数据时，这两列必须和 INSERT INTO target_table (col1, col2, ...) 中声明的字段一一对应。
典型翻车点：
- 目标表有自增主键或默认值字段（如
id INT IDENTITY、created_at DATETIME2 DEFAULT GETDATE()），但 INSERT 语句没跳过它们，导致报错Cannot insert explicit value for identity column - UNPIVOT 出来的值列是
VARCHAR，而目标表对应字段是DECIMAL，且含非数字字符（如'N/A'），INSERT 时直接Conversion failed - 漏写
SELECT中的关联字段（如原表的product_id），导致插入后无法溯源
安全做法是：UNPIVOT 前先把关键维度字段（如 product_id, region）保留在外层 SELECT 中，再和 UNPIVOT 结果做 CROSS APPLY 或子查询联接。
SQL Server 2005+ 才支持 UNPIVOT，旧版本得用 UNION ALL 模拟
如果你连 UNPIVOT 关键字都报错，大概率是 SQL Server 版本低于 2005，或者数据库兼容级别设得太低（如 80 = SQL Server 2000）。检查方法：SELECT compatibility_level FROM sys.databases WHERE name = DB_NAME()。
替代方案是手写 UNION ALL：
SELECT product_id, 'Q1' AS Quarter, CAST(Q1 AS DECIMAL(10,2)) AS SalesAmount FROM sales_data UNION ALL SELECT product_id, 'Q2', CAST(Q2 AS DECIMAL(10,2)) FROM sales_data UNION ALL SELECT product_id, 'Q3', CAST(Q3 AS DECIMAL(10,2)) FROM sales_data
注意：UNION ALL 比 UNPIVOT 更啰嗦，但可控性强——每块都能加 WHERE Q1 IS NOT NULL 过滤脏数据，UNPIVOT 则做不到这点。
UNPIVOT 后的 NULL 值默认被丢弃，需要保留就得预处理
UNPIVOT 默认跳过值为 NULL 的单元格，不会生成对应行。如果业务要求保留 NULL 记录（比如表示“该季度未上报”），不能依赖 UNPIVOT 自身行为。
解决路径只有两个：
- 在 UNPIVOT 前把 NULL 替换成占位符，比如
ISNULL(Q1, -999)，插入后再在目标表里转回 NULL（需额外 UPDATE） - 改用
CROSS APPLY+ 表值构造器，完全掌控每一行输出逻辑：SELECT product_id, q.Quarter, q.SalesAmount FROM sales_data CROSS APPLY (VALUES ('Q1', Q1), ('Q2', Q2), ('Q3', Q3) ) AS q(Quarter, SalesAmount)这个写法天然保留 NULL，且无需担心列类型不一致问题。
真正麻烦的不是语法，而是搞清“哪些 NULL 是缺失值，哪些是有效零值”——这得翻业务文档，UNPIVOT 本身不帮你做语义判断。
