SqlBulkCopy导入CSV时NULL值处理及多配置疑问

一、KeepNulls的实际作用和你的预期差异 #

你遇到的问题核心是对KeepNulls的理解偏差：KeepNulls仅当数据源中的值是DBNull.Value时，才会将对应的SQL表字段设置为NULL。而默认情况下，PowerShell读取CSV时，空字段会被解析为空字符串（""），而非DBNull.Value——这就是为什么你看到空字段变成了SQL里的空字符串，而非预期的NULL。

简单来说：KeepNulls不会自动帮你把空字符串转成NULL，它只是确保当数据源里已经是DBNull的时候，不会被SQL Server默认替换成字段的默认值（比如空字符串）。

二、正确配置SqlBulkCopy同时启用KeepNulls和TableLock #

要实现你的需求，需要分两步操作：

1. 读取CSV时，将空字符串转换为DBNull.Value
2. 正确配置SqlBulkCopy的KeepNulls属性和TableLock选项

1. 处理CSV空值为DBNull #

在读取CSV的环节，需要遍历每一行的每个字段，把空字符串替换成DBNull.Value。示例代码如下：

$csvPath = "你的CSV文件路径.csv"
$csvData = Import-Csv -Path $csvPath

# 创建DataTable存储处理后的数据
$table = New-Object System.Data.DataTable
foreach ($column in $csvData[0].PSObject.Properties.Name) {
    $table.Columns.Add($column) | Out-Null
}

# 遍历CSV行，转换空字段为DBNull
foreach ($row in $csvData) {
    $newRow = $table.NewRow()
    foreach ($column in $table.Columns.ColumnName) {
        $value = $row.$column
        $newRow[$column] = if ([string]::IsNullOrEmpty($value)) { [System.DBNull]::Value } else { $value }
    }
    $table.Rows.Add($newRow)
}

2. 同时启用KeepNulls和TableLock #

注意：TableLock是SqlBulkCopyOptions枚举中的值，且SqlBulkCopy的Options属性是只读的，必须在实例化SqlBulkCopy对象时指定该选项，之后再设置KeepNulls为$true。示例代码：

$connectionString = "Server=你的SQL服务器;Database=目标数据库;Integrated Security=True;"
$destinationTable = "目标表名"

# 实例化SqlBulkCopy时指定TableLock选项
$bulkCopy = New-Object System.Data.SqlClient.SqlBulkCopy(
    $connectionString,
    [System.Data.SqlClient.SqlBulkCopyOptions]::TableLock
)

# 启用KeepNulls
$bulkCopy.KeepNulls = $true
$bulkCopy.DestinationTableName = $destinationTable

# 执行批量复制
$bulkCopy.WriteToServer($table)
$bulkCopy.Close()

如果需要同时启用多个SqlBulkCopyOptions（比如TableLock+UseInternalTransaction），可以用位或操作组合：

$options = [System.Data.SqlClient.SqlBulkCopyOptions]::TableLock -bor [System.Data.SqlClient.SqlBulkCopyOptions]::UseInternalTransaction
$bulkCopy = New-Object System.Data.SqlClient.SqlBulkCopy($connectionString, $options)

验证效果 #

经过上述处理后，CSV中的空字段会被转换成DBNull.Value，再配合KeepNulls = $true，SQL Server就会将这些字段插入为NULL，而非空字符串；同时TableLock选项会在批量复制期间锁定目标表，有效提升导入性能。

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