PHP通过ODBC批量插入多行数据至MSSQL时返回错误

你遇到的这个问题其实挺常见的，核心原因是旧版SQL Server ODBC驱动对多行参数化INSERT语句的支持有限——哪怕你反复核对后确认列数和值的数量完全匹配，驱动也可能无法正确解析多组VALUES里的占位符。下面给你几个可行的解决方案：

1. 升级ODBC驱动 #

先排查你的ODBC驱动版本：如果用的是SQL Server Native Client（比如10.0及更早版本），这类旧驱动对多行参数化INSERT的兼容性很差，甚至不支持这种语法。建议升级到ODBC Driver 17 for SQL Server（微软官方最新的ODBC驱动），新版本对批量参数化查询的支持更完善，大概率能直接解决这个问题。

2. 用事务包裹逐行插入（性能优化版） #

既然逐行插入可以正常执行，那我们可以用事务把所有插入操作包裹起来，避免每次插入都单独提交事务，这样性能和纯批量插入相差不大。示例代码如下：

// 开启事务，关闭自动提交
odbc_autocommit($connection_id, false);

$insertSql = 'INSERT INTO tzeit ([pers_id],[card_nr],[time],[type],[terminal_nr],[tzeit_id]) VALUES (?, ?, ?, ?, ?, ?)';
$stmt = odbc_prepare($connection_id, $insertSql);

// 把参数数组拆分成每6个一组（对应一行数据）
$batches = array_chunk($params, 6);
foreach ($batches as $batch) {
    if (!odbc_execute($stmt, $batch)) {
        // 出错则回滚事务
        odbc_rollback($connection_id);
        die(odbc_errormsg($connection_id));
    }
}

// 所有插入完成后提交事务
odbc_commit($connection_id);
// 恢复自动提交
odbc_autocommit($connection_id, true);

3. 使用MSSQL表值参数（推荐的批量插入方式） #

这是MSSQL官方推荐的批量数据插入方式，不仅能避免占位符数量问题，还能获得更好的性能，同时保持参数化的安全性。步骤如下：

第一步：在MSSQL中创建用户定义表类型 #

CREATE TYPE dbo.TzeitTableType AS TABLE (
    pers_id varchar(4) NOT NULL,
    card_nr varchar(4) NOT NULL,
    time datetime NOT NULL,
    type int NOT NULL,
    terminal_nr int NOT NULL,
    tzeit_id bigint NOT NULL
);

第二步：在PHP中使用表值参数插入数据 #

// 把参数数组拆分成每行的结构化数据
$rows = array_chunk($params, 6);
$tvpData = [];
foreach ($rows as $row) {
    $tvpData[] = [
        'pers_id' => $row[0],
        'card_nr' => $row[1],
        'time' => $row[2],
        'type' => $row[3],
        'terminal_nr' => $row[4],
        'tzeit_id' => $row[5]
    ];
}

// 准备带表值参数的SQL语句
$sql = 'INSERT INTO tzeit ([pers_id],[card_nr],[time],[type],[terminal_nr],[tzeit_id])
        SELECT pers_id, card_nr, time, type, terminal_nr, tzeit_id FROM ?';

// 执行表值参数插入（注意：需要ODBC驱动版本足够新才能支持）
$stmt = odbc_prepare($connection_id, $sql);
if (odbc_execute($stmt, [$tvpData])) {
    echo '批量插入成功';
} else {
    echo odbc_errormsg($connection_id);
}

为什么会出现这个错误？ #

虽然你核对了占位符和参数数量完全匹配，但旧版ODBC驱动在解析VALUES (?,?), (?,?)这种多行参数化语法时，可能无法正确识别所有占位符的数量，或者驱动本身对单查询的参数数量有隐性限制（哪怕48个参数没超过纸面限制，分组的语法也可能不被支持）。而逐行插入时是单组参数，驱动能正确处理，所以不会报错。

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