BULK INSERT最快但需环境对齐:文件须存于SQL Server本地磁盘且服务账户有读取权限,UNC路径不支持;必须用TABLOCK+批量日志模式提速;CSV含引号或换行应改用FORMAT='CSV'(2017+)。

BULK INSERT 是 SQL Server 原生最快的数据导入方式,但“快”是有前提的——它不接受客户端路径、不自动类型转换、不处理权限盲区。直接跑 BULK INSERT 却卡住或报错,大概率不是语句写错了,而是环境没对齐。
文件路径必须对 SQL Server 服务账户可见
常见错误现象:BULK INSERT 报错 “Cannot bulk load because the file … does not exist”,而你在 SSMS 里用 Windows 身份验证登录后明明能手动打开该文件。
- SQL Server 进程(如
sqlservr.exe)以某个 Windows 账户身份运行(通常是NT ServiceMSSQLSERVER或自定义域账户),BULK INSERT是它自己去读文件,不是你当前登录用户在读 - 本地路径(如
C:datainput.csv)只在你本机有效,SQL Server 服务看不到;UNC 路径(如\servershareinput.csv)必须给服务账户授予读取权限 - Azure SQL 数据库不支持本地/UNC 路径,只能用 Azure 存储(需配置
DATA SOURCE和 SAS/托管标识) - 临时验证方法:用服务账户身份远程登录服务器,在资源管理器中手动访问该路径,确认可读
TABLOCK + BULK_LOGGED 是提速刚需组合
默认情况下,BULK INSERT 用行锁 + 完整日志模式,几百万行可能跑一小时还卡死。
- 务必加
TABLOCK提示:它让 SQL Server 对整张表加意向锁,避免逐行锁争用 - 导入前切恢复模式:
ALTER DATABASE yourdb SET RECOVERY BULK_LOGGED;导入完可切回FULL(如需后续日志备份) - 若数据库已为
SIMPLE恢复模式,跳过切换,但注意:无法做时点还原 - 不加
TABLOCK时,即使数据量不大,也可能因锁升级失败报错Timeout expired
字段映射和格式容错必须显式控制
CSV 含换行符、引号、NULL 或列数不匹配时,BULK INSERT 默认整批失败,错误信息只说“批量加载失败”,不指明哪一行哪一列。
- SQL Server 2017+ 推荐用
FORMAT = 'CSV'替代手写FIELDTERMINATOR和ROWTERMINATOR,它能自动处理双引号包裹、内部换行等 RFC 4180 行为 - 字段与目标表列不一致(如源只有 3 列,目标有 7 列),必须用格式化文件(XML 或非 XML 格式文件)通过
FORMATFILE = 'path.xml'显式映射 - 源字段含空值且目标列允许 NULL,加
KEEPNULLS;否则空字符串会被转成默认值(如GETDATE()) - 首行为表头?加
FIRSTROW = 2;否则第一行会被当数据插进去
错误捕获和调试不能只靠 TRY/CATCH
TRY/CATCH 在 BULK INSERT 中基本无效——错误发生在外部 I/O 层,T-SQL 引擎收不到结构化异常。
- 用
ERRORFILE = 'D:logsulk_error.log'把失败行单独输出,配合MAXERRORS = 10控制容忍阈值 -
ERRORFILE路径同样需对 SQL Server 服务账户可写,否则连错误日志都写不了 - 导入后检查实际行数:
SELECT COUNT(*) FROM target_table,别只信“命令已成功完成” - 若用
OPENROWSET(BULK)替代BULK INSERT,它支持IGNORE_CONSTRAINTS等更细粒度提示,但性能略低,适合需要跳过某些约束的场景
真正卡住的地方,往往不在语法,而在路径权限、恢复模式、格式文件路径这三个点上。先确认服务账户能不能读写那些路径,再动代码。

















