调用Pandas的to_sql()返回负值代表什么含义？

你遇到的负值并不是实际写入失败的行数，而是ODBC驱动返回的状态码，具体原因如下：

1. 默认插入模式的rowcount问题 #

当不指定method="multi"时，Pandas默认会逐行执行INSERT语句。此时pyodbc驱动返回的rowcount可能不是实际插入的行数，而是ODBC定义的状态码：

• 比如-1对应SQL_NO_DATA，这里属于驱动返回逻辑偏差，明明有数据写入却返回该状态码；
• 其他负值（如-11、-56）也是ODBC的特定警告类状态码，被Pandas直接当作rowcount累加，最终得到异常的负数结果。

2. method="multi"为何正常 #

当使用method="multi"时，Pandas会将多条记录打包成一个批量INSERT语句（格式为INSERT INTO ... VALUES (...), (...), ...），执行这条语句后，SQL Server驱动会返回实际被影响的行数，Pandas据此累加得到正确的写入数量（比如你例子中的325）。

3. 写入成功的验证方式 #

虽然返回了负数，但数据库写入是正常的——这些状态码只是驱动传递的信息/警告，不是错误。你可以直接查询目标表的行数确认：

# 验证写入行数的示例代码
with data_lake.connect() as conn:
    count_result = conn.execute("SELECT COUNT(*) FROM PLSubmittalType")
    print(count_result.scalar())  # 应输出325

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