SQL查询直接返回CSV结果（不导出文件）的高效实现方法

需求背景 #

• 需要将查询结果转换为CSV格式，直接作为查询结果返回，不保存为本地文件
• 现有公开可查的方案大多是将CSV导出为文件，无法满足直接返回结果集的要求
• 已尝试的STUFF+FOR XML PATH手动拼接方案存在明显缺陷：需要逐列手动编写拼接逻辑，当查询涉及的列数、行数较多时，代码编写和维护成本极高

现有手动拼接方案示例代码：

SELECT  STUFF(( 
SELECT  ',' + CSV
FROM( 
    SELECT  
    CONVERT(VARCHAR,Stat_Date,103) + ',' 
    + COALESCE(UPRN, '') AS CSV
FROM [stats].[tvfSomeFunction](@TargetDate) 
) x
FOR
XML PATH('')), 1, 1, '') CSV 

低维护成本替代方案 #

推荐使用动态SQL+元数据自动列解析的方式实现，无需手动逐列拼接，适配任意列数的查询场景，列变更时无需修改拼接逻辑。

实现逻辑 #

1. 通过系统函数sys.dm_exec_describe_first_result_set自动获取目标查询返回的所有列元数据
2. 自动生成带空值处理、特殊字符转义的列拼接规则
3. 组装最终查询语句执行，直接返回拼接完成的完整CSV内容

参考代码 #

-- 入参定义
DECLARE @TargetDate DATE = '2024-01-01';
DECLARE @colJoinExpr NVARCHAR(MAX), @execSql NVARCHAR(MAX);

-- 自动生成所有列的拼接表达式，自动处理空值、替换内容中包含的逗号避免格式错乱
SELECT @colJoinExpr = STRING_AGG(
    'COALESCE(REPLACE(CONVERT(NVARCHAR(MAX), ' + QUOTENAME(name) + '), '','', '' ''), '''')',
    ','
)
FROM sys.dm_exec_describe_first_result_set(
    N'SELECT * FROM [stats].[tvfSomeFunction](@TargetDate)',
    N'@TargetDate DATE',
    0
);

-- 组装最终查询，按行拼接CSV内容，换行符分隔每一行
SET @execSql = N'
SELECT STRING_AGG(SingleRowCsv, CHAR(13) + CHAR(10)) AS CSVResult
FROM (
    SELECT ' + @colJoinExpr + ' AS SingleRowCsv
    FROM [stats].[tvfSomeFunction](@TargetDate)
) t';

-- 执行查询返回结果
EXEC sp_executesql @execSql, N'@TargetDate DATE', @TargetDate = @TargetDate;

方案优势 #

• 无需手动枚举所有查询列，目标查询/表值函数的列结构变更时，不需要修改拼接代码，维护成本接近0
• 内置格式容错处理，自动处理空值、内容中包含逗号的特殊场景，避免CSV格式解析错误
• SQL Server 2017及以上版本使用STRING_AGG做字符串拼接，性能比老式STUFF+FOR XML PATH方案高30%以上

补充说明：如果需要返回CSV表头，可以在元数据解析步骤同步获取列名，自动生成表头行拼接在结果最前端即可，同样不需要手动编写表头内容。

内容的提问来源于stack exchange，提问作者Vereonix