在使用SqlBulkCopy进行SQLServer大批量数据写入时，目标表中定义了缺省值（DEFAULT）的列往往不会如预期那样自动填充。这与普通INSERT语句的行为不同，理解其底层机制才能写出稳定的导入程序。
为什么SqlBulkCopy不触发缺省值
SqlBulkCopy的工作方式是将内存中的DataTable或DataReader数据以最小日志模式直接推送到目标表。它在执行时本质上使用了类似BCP的工具，并且要求目标列的值由数据源提供。如果DataTable中没有某一列，而目标表该列有缺省值，SqlBulkCopy并不会生成包含DEFAULT关键字的INSERT，而是将该列视为未映射，导致写入NULL（若列允许空）或抛出异常（若列不允许空且无缺省值生效路径）。
普通INSERT语句中，若省略列名，SQLServer会自动应用该列的缺省值约束。但SqlBulkCopy的批量协议不允许这种省略，它要么依赖ColumnMappings显式对应，要么按列序隐式对应。只要映射存在且源值为NULL，数据库就收到NULL，缺省值约束没有介入机会。因此开发者必须主动设计映射策略。
通过ColumnMappings控制缺省值列
最稳妥的做法是在代码中明确定义ColumnMappings，并且对于希望使用缺省值的列，不在源DataTable中提供值（保持DBNull或根本不建该列），同时在映射中依然声明目标列名。SqlBulkCopy在映射时若源无对应列，会忽略该列写入，从而让数据库使用缺省值。
以下示例展示如何只映射部分列，让表中的CreatedTime列（定义了GETDATE()缺省值）自动生成：
using System.Data;
using System.Data.SqlClient;
DataTable dt = new DataTable();
dt.Columns.Add("UserName", typeof(string));
dt.Columns.Add("Age", typeof(int));
dt.Rows.Add("张三", 28);
dt.Rows.Add("李四", 35);
using (SqlConnection conn = new SqlConnection("server=.;database=TestDb;uid=sa;pwd=ipipp.com"))
{
conn.Open();
using (SqlBulkCopy bulk = new SqlBulkCopy(conn))
{
bulk.DestinationTableName = "Users";
// 只映射提供的列，CreatedTime列不在映射中，由数据库缺省值填充
bulk.ColumnMappings.Add("UserName", "UserName");
bulk.ColumnMappings.Add("Age", "Age");
bulk.WriteToServer(dt);
}
}
上面代码中，Users表的CreatedTime字段设置了GETDATE()为缺省值。由于未映射CreatedTime，SqlBulkCopy不会尝试写入它，SQLServer在插入行时自动填入当前时间。这种方式比在客户端计算时间更可靠，也减轻了传输量。
源数据包含缺省值列时的处理
有时DataTable来自通用组件，已经包含了所有列，包括应有缺省值的列。此时若直接写入，NULL会覆盖缺省值。解决方案是将这些列的值设为DBNull，并结合映射让数据库忽略，或者从DataTable中移除该列后再写入。
示例：将已有DataTable中缺省值列置为DBNull，并保留映射：
foreach (DataRow row in dt.Rows)
{
// Status列在数据库有缺省值1，这里不提供则置为DBNull
row["Status"] = DBNull.Value;
}
using (SqlConnection conn = new SqlConnection("server=.;database=TestDb;uid=sa;pwd=ipipp.com"))
{
conn.Open();
using (SqlBulkCopy bulk = new SqlBulkCopy(conn))
{
bulk.DestinationTableName = "Users";
bulk.ColumnMappings.Add("UserName", "UserName");
bulk.ColumnMappings.Add("Age", "Age");
bulk.ColumnMappings.Add("Status", "Status");
bulk.WriteToServer(dt);
}
}
注意，如果Status列在数据库不允许NULL且没有缺省值，上述写法会失败。正确做法是干脆从DataTable移除Status列，不建立映射，如同前一节做法。因此设计导入层时应区分“必填列”和“可缺省列”。
使用SqlBulkCopyOptions与保持标识列
当表含有IDENTITY列且也含缺省值列时，可组合使用SqlBulkCopyOptions.KeepIdentity等选项。但缺省值列与标识列无关，仍需靠映射控制。下表列出常见列类型与推荐策略：
| 列类型 | 是否有缺省值 | 推荐做法 |
|---|---|---|
| 标识列 | 否 | 使用KeepIdentity或忽略映射由数据库生成 |
| 时间列 | 是（GETDATE） | 不映射该列，让数据库填充 |
| 状态列 | 是（如1） | 源中置DBNull且不映射，或移除该列 |
| 普通必填列 | 否 | 必须提供值并映射 |
通过明确划分这些类别，批量导入逻辑会清晰很多。建议在数据访问层封装一个配置类，声明哪些列允许使用缺省值，动态构建ColumnMappings，避免散落各处的魔法字符串。
常见误区与排查方法
一个典型误区是认为只要目标表有缺省值，无论怎么映射都不会出问题。实际测试时常发现导入后时间字段全为NULL，就是因为DataTable里该列被显式赋了NULL且建立了映射。排查时可临时打开SQL Server Profiler，观察SqlBulkCopy生成的语句，或直接查询导入后数据验证缺省值是否生效。
另一个误区是在事务中混用SqlBulkCopy和普通INSERT，以为缺省值行为一致。批量写入若失败回滚，普通INSERT的缺省值行也会消失，但两者约束路径不同。保持导入程序单纯使用SqlBulkCopy并正确配置映射，才能减少边界问题。
SqlBulkCopySQLServer缺省值列修改时间：2026-07-31 18:33:30