Python用pyodbc向MSSQL插入特定字符串报错：超出8字节表示范围

错误原因 #

你直接用字符串拼接生成INSERT语句，当instanceId的值是OI-9786E543971246B29470AFA10414A1E2时，SQL Server会错误地将字符串中的9786E片段识别为浮点数的科学计数法格式，试图将其解析为数值，最终触发超出范围的报错。哪怕给字符串加了单引号，这种拼接方式仍会让数据库对内容做不必要的类型推断，导致问题。

解决方案：使用参数化查询 #

彻底放弃字符串拼接SQL的方式，改用pyodbc的参数化查询功能。参数化查询会将每个字段值作为独立参数传递，让驱动和数据库正确处理类型映射，既避免类型解析错误，又能防止SQL注入。

修改后的代码 #

# 定义参数化的INSERT模板，用?作为占位符
insert_sql = """
INSERT INTO [x].[dbo].[x] ([commcell],[clientName],[clientDisplayName],[clientHostName],[instanceId])
VALUES (?, ?, ?, ?, ?)
"""

batch_size = 300
params_list = []

# 开启事务
cursor.execute("BEGIN TRANSACTION")

for client in clients:
    # 收集参数到列表
    params_list.append((
        client['commcell'],
        client['clientName'],
        client['clientDisplayName'],
        client['clientHostName'],
        client['instanceId']
    ))
    
    # 达到批量大小就执行插入
    if len(params_list) == batch_size:
        cursor.executemany(insert_sql, params_list)
        params_list = []

# 插入剩余的记录
if params_list:
    cursor.executemany(insert_sql, params_list)

# 提交事务
cursor.commit()

为什么这样有效 #

参数化查询不会把变量内容直接嵌入SQL语句，而是通过驱动安全传递参数值，数据库会严格按照列定义的字符串类型（varchar/nvarchar等）存储数据，不会再错误解析字符串中的科学计数法片段。同时这种方式的批量插入效率也比拼接SQL更高。

内容的提问来源于stack exchange，提问作者Benjaminas Bilevičius