Python(pyodbc)向SQL Server传递表值参数(TVP)报错求助

你的问题出在SQL语句语法错误和Python参数传递两个核心点上，以下是具体修正方案：

1. 修正SQL语句的关键错误 #

• TVP变量声明语法错误：你用DECLARE @table_values TABLE = ?是错误的，表值参数(TVP)必须使用SQL Server中预先创建的用户定义表类型，而非普通TABLE变量。正确写法是指定类型名：

  DECLARE @table_values [dbo].[table_type_name] = ?;
  

  前提是你已经在SQL Server中创建了对应表类型，示例：

  CREATE TYPE dbo.table_type_name AS TABLE (
      id INT,
      col2 VARCHAR(50), -- 需与Python传递的列顺序、类型完全匹配
      email VARCHAR(100)
  );
  

• UPDATE语句语法错误：SET contacts.is_active = 0, 末尾多了逗号，直接删除即可；另外FROM子句的table_name与SET中的contacts.is_active不匹配，应改为contacts避免列找不到的错误。

修正后的完整SQL：

SAVE_QUERY= """
    SET NOCOUNT ON;
    SET ANSI_NULLS ON;

    DECLARE @table_values [dbo].[table_type_name] = ?;

    UPDATE 
        contacts
    SET 
        contacts.is_active = 0
    FROM
        contacts
    LEFT JOIN
        @table_values CC
    ON
        CC.id = contacts.id
    WHERE
        CC.email IS NULL;
"""

2. 修正Python的参数传递逻辑 #

你当前的params = [(table_values,None)]是多余嵌套，TVP作为单个参数传递即可，无需额外包裹：

# TVP定义：(表类型名, 架构名, 数据行)
table_values = [
    'table_type_name',
    'dbo',
    (1, None, 'Test')  # 列顺序必须与SQL表类型完全一致
]

# 直接传递TVP元组，末尾逗号确保是元组类型
params = (table_values,)

# 执行查询
cursor.execute(SAVE_QUERY, params)

额外注意事项 #

• 若要传递多行数据，将数据部分改为列表即可：

  table_values = [
      'table_type_name',
      'dbo',
      [(1, None, 'Test'), (2, 'Demo', 'test@example.com')]
  ]
  

• 必须保证Python传递的列顺序、数据类型与SQL Server的用户定义表类型完全匹配，否则会触发类型不兼容错误。

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