如何用PowerShell 5.x读取SQL Server 2019中image类型字段数据到文件

问题根源 #

1. GetSqlBytes参数错误：原注释里的$reader.GetSqlBytes(0)指定了错误的列索引，file_data在SELECT语句中是第4个字段（索引从0开始为3），该方法仅需传入目标字段的索引即可。
2. GetBytes参数错误：代码中误用了未定义的变量$document_file_size，实际应该用已获取的$doc_size，同时要确保参数顺序与方法要求一致。

修正后的代码实现 #

方法1：使用GetSqlBytes（更简洁）

$SelectSqlCmd.CommandText = "SELECT id, file_name, file_size, file_data FROM documents"
$SqlConnection.Open()
$reader = $SelectSqlCmd.ExecuteReader()

while ($reader.Read()) {
    $doc_id   = $reader.GetValue(0)
    $doc_name = $reader.GetValue(1)
    $doc_size = $reader.GetValue(2)
    # 直接获取file_data字段的SQLBytes对象，转成字节数组
    $sqlBytes = $reader.GetSqlBytes(3)
    $buffer = $sqlBytes.Value
    # 后续可将buffer写入文件等操作
}

$reader.Close()
$SqlConnection.Close()

方法2：使用GetBytes（手动处理缓冲区）

$SelectSqlCmd.CommandText = "SELECT id, file_name, file_size, file_data FROM documents"
$SqlConnection.Open()
$reader = $SelectSqlCmd.ExecuteReader()

while ($reader.Read()) {
    $doc_id   = $reader.GetValue(0)
    $doc_name = $reader.GetValue(1)
    $doc_size = $reader.GetValue(2)
    # 用实际的doc_size创建字节数组缓冲区
    $buffer = New-Object byte[] $doc_size
    # 正确调用GetBytes：列索引、数据起始偏移、缓冲区、缓冲区偏移、读取长度
    $bytesRead = $reader.GetBytes(3, 0, $buffer, 0, $doc_size)
    # 验证读取的字节数是否与预期一致（可选）
    if ($bytesRead -ne $doc_size) {
        Write-Warning "读取文件$doc_name时字节数不匹配，预期$doc_size，实际$bytesRead"
    }
    # 后续操作
}

$reader.Close()
$SqlConnection.Close()

关键说明 #

• SQL Server的image字段属于大对象类型，GetSqlBytes可以直接获取完整的字节数据，无需手动处理缓冲区，适合大部分场景。
• 使用GetBytes时，需要确保缓冲区大小足够，且变量名、参数顺序完全对应方法定义，避免因参数不匹配报错。

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