使用PowerShell导入WebEx API数据到SQL Server时WriteToServer报错求助

问题现象 #

• CSV数据和DataTable已成功加载，但执行SqlBulkCopy的WriteToServer方法时返回错误：

  数据源中的String类型值无法转换为目标列的int类型

• 错误详情显示DestinationColumn、DestinationOrdinal、SourceColumn、SourceOrdinal均返回-1
• SQL Server目标表仅显示列名，无数据写入
• 已确认列名完全对齐，SQL数据类型配置：仅meetingId为int类型，start/end为datetime类型，其余列均为varchar或nvarchar类型

涉及PowerShell代码片段 #

try {
    $bulkCopy.WriteToServer($dt)
    Write-Host "Data successfully inserted into the table."
}
 catch {
    Write-Host "An error occurred: $_"
    foreach ($errorRecord in $_.Exception.Errors) {
        Write-Host "SQL Error: $($errorRecord.Message)"
    }
} finally {
    $bulkCopy.Close()
}

排查与解决方向 #

1. DataTable列类型未匹配SQL目标列
   通过$dt.Columns.Add添加列时，若未显式指定类型，PowerShell默认会按字符串处理，导致meetingId等列类型与SQL侧不兼容。需显式指定列类型：

   $dt.Columns.Add("meetingId", [int])
   $dt.Columns.Add("start", [datetime])
   $dt.Columns.Add("end", [datetime])
   # 其余varchar/nvarchar列可指定[string]类型
   

   同时添加行数据时，要确保meetingId的值被转换为int类型，例如$dataRow["meetingId"] = [int]$csvRow.meetingId。

2. 添加显式列映射
   自动列名映射可能因大小写、隐式规则失效，导致DestinationOrdinal等参数返回-1。需手动添加列映射关系：

   $bulkCopy.ColumnMappings.Add("meetingId", "meetingId")
   $bulkCopy.ColumnMappings.Add("start", "start")
   $bulkCopy.ColumnMappings.Add("end", "end")
   # 依次添加所有列的映射
   

3. 校验CSV数据有效性
   检查CSV中meetingId列是否存在空值、非数值内容（如表头重复、备注文本），这些内容会触发类型转换失败。导入时可增加校验逻辑：

   foreach ($row in $csvData) {
       $validId = $null
       if (-not [int]::TryParse($row.meetingId, [ref]$validId)) {
           Write-Warning "无效meetingId值：$($row.meetingId)，跳过该行"
           continue
       }
       $dataRow = $dt.NewRow()
       $dataRow["meetingId"] = $validId
       # 其他列赋值逻辑
       $dt.Rows.Add($dataRow)
   }
   

4. 启用流式传输优化
   若数据量较大，启用EnableStreaming可减少内存消耗，同时避免部分隐式转换问题：

   $bulkCopy.EnableStreaming = $true
   

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