使用T-SQL的BCP工具导出SQL Server表为CSV时如何添加表头？

可以通过两种实用方式实现将列名作为第一行写入目标CSV文件：

方法一：先写入列名，再追加表数据 #

这种方式先通过系统视图获取表的列名并写入文件开头，再将表数据追加到文件中，操作简单且无需修改表数据类型：

DECLARE @archivoOUT varchar(800)
DECLARE @sql nvarchar(1000)
DECLARE @columnNames VARCHAR(MAX)

-- 获取[dbo].[TEMP_res]的列名，按表中顺序拼接为逗号分隔的字符串
SELECT @columnNames = STRING_AGG(name, ',') WITHIN GROUP (ORDER BY column_id)
FROM sys.columns
WHERE object_id = OBJECT_ID('[dbo].[TEMP_res]')

SET @archivoOUT = CONCAT('D:\archivosolicitudrestcate', FORMAT (GETDATE(), 'yyyyMMdd'),'.csv')

-- 1. 将列名写入CSV文件（覆盖原有文件）
SET @sql = N'echo ' + @columnNames + N' > ' + @archivoOUT
EXEC master..xp_cmdshell @sql

-- 2. 将表数据追加到CSV文件末尾
SET @sql = N'bcp "SELECT * FROM [dbo].[TEMP_res]" queryout - -S '+@@SERVERNAME+' -d CentroMedico -c -T >> '+@archivoOUT
EXEC master..xp_cmdshell @sql

注意事项： #

• 如果列名包含逗号、空格等特殊字符，需给列名添加引号，修改列名拼接逻辑为：STRING_AGG(''''+name+'''', ',')，同时echo命令改为echo "'" + @columnNames + "'" > ...
• 原脚本同时使用-c（ASCII字符模式）和-w（Unicode模式）可能导致编码冲突，建议只保留-c参数统一编码

方法二：通过UNION ALL合并列名与数据导出 #

这种方式将列名作为一行数据与表数据合并后一次性导出，适合需要严格控制输出格式的场景：

DECLARE @archivoOUT varchar(800)
DECLARE @sql nvarchar(1000)

SET @archivoOUT = CONCAT('D:\archivosolicitudrestcate', FORMAT (GETDATE(), 'yyyyMMdd'),'.csv')

-- 构造包含列名和数据的查询（需将所有列转换为字符串类型，确保UNION ALL类型匹配）
SET @sql = 'bcp "
SELECT ''列名1'', ''列名2'', ''列名3'' -- 替换为[dbo].[TEMP_res]的实际列名
UNION ALL
SELECT CAST(列名1 AS VARCHAR(MAX)), CAST(列名2 AS VARCHAR(MAX)), CAST(列名3 AS VARCHAR(MAX)) -- 对应表的实际列名及类型转换
FROM [dbo].[TEMP_res]
" queryout '+@archivoOUT+' -S '+@@SERVERNAME+' -d CentroMedico -c -T'

EXEC master..xp_cmdshell @sql

注意事项： #

• 必须确保列名行的字符串类型与数据行转换后的类型完全匹配，否则会触发类型不兼容错误
• 需要手动替换所有列名和对应的类型转换逻辑，更适合列数较少的表

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