使用pyodbc调用SQL Server存储过程，TVP首行含None值触发无效SQL数据类型错误如何解决？

AI 小北

2026-6-28

解决pyodbc调用SQL Server存储过程TVP含None值的报错问题

不需要放弃使用表值参数（TVP），通过显式指定TVP列的SQL数据类型即可解决该错误。当TVP中存在None值时，pyodbc无法自动推断对应列的数据类型，导致绑定参数失败，显式指定类型就能避免这个问题。

具体实现步骤

明确SQL Server中已创建的用户定义表类型名称
使用pyodbc.SQLServerTableValuedParameter类构造TVP，显式声明每一列对应的SQL数据类型
将包含None值的数据添加到TVP中，再传入存储过程调用

代码示例

假设SQL Server中定义的表类型为：

CREATE TYPE dbo.MyTVPType AS TABLE (
    Id INT,
    Name VARCHAR(50)
)

对应的Python代码：

import pyodbc

# 建立数据库连接
conn = pyodbc.connect("你的连接字符串")
cursor = conn.cursor()

# 构造包含None值的TVP数据
tvp_data = [
    (1, "Alice"),
    (2, None),  # 含None值的行
    (3, "Bob")
]

# 显式指定TVP的表类型名称和列数据类型
tvp = pyodbc.SQLServerTableValuedParameter(
    "dbo.MyTVPType",
    [(pyodbc.SQL_INT, pyodbc.SQL_VARCHAR)]  # 列类型顺序需与SQL表类型一致
)
tvp.add_rows(tvp_data)

# 执行存储过程
cursor.execute("{CALL dbo.stored_procedure (?, ?)}", (None, tvp))
conn.commit()

# 关闭连接
cursor.close()
conn.close()

如果使用字典形式的行数据，可更清晰地对应列名与类型：

tvp_data = [
    {"Id": 1, "Name": "Alice"},
    {"Id": 2, "Name": None},
    {"Id": 3, "Name": "Bob"}
]

tvp = pyodbc.SQLServerTableValuedParameter(
    "dbo.MyTVPType",
    [("Id", pyodbc.SQL_INT), ("Name", pyodbc.SQL_VARCHAR)]
)
tvp.add_rows(tvp_data)