如何使用SQLAlchemy调用含用户定义表类型参数的存储过程

我之前也踩过这个坑——直接传列表根本不生效，因为SQLAlchemy对接MSSQL的表值参数需要专门的处理方式，下面给你一步步拆解怎么实现：

首先，你得借助pyodbc的TableValuedParameter类来包装数据，这是MSSQL驱动识别表值参数的标准方式。假设你已经装好了pyodbc和适配版本的SQLAlchemy，直接看实操：

步骤1：导入必要模块 #

from sqlalchemy import text
import pyodbc

步骤2：把列表数据包装成表值参数 #

比如你要传入的字符串列表是：

name_list = ["Alice", "Bob", "Charlie"]

因为你的StringTable类型只有strValue一列，所以要把每个字符串包装成单元素元组，再传给TableValuedParameter：

# 第一个参数是数据库中自定义表类型的完整名称（含架构dbo）
tvp = pyodbc.TableValuedParameter(
    'dbo.StringTable',
    [(name,) for name in name_list]
)

步骤3：用SQLAlchemy Session调用存储过程 #

和你之前调用普通存储过程的逻辑类似，但参数要传包装好的TVP对象：

with session.begin():
    result = session.execute(
        text("EXEC prc_add_names @names = :tvp_param"),
        {"tvp_param": tvp}
    )
    # 如果存储过程有返回结果，可通过result.fetchall()获取

几个关键注意点 #

• 确保你的数据库连接用的是pyodbc驱动，连接字符串格式类似：mssql+pyodbc://username:password@server/database?driver=ODBC+Driver+17+for+SQL+Server
• 自定义表类型的名称必须完全匹配（包括dbo架构），不然驱动找不到对应的类型
• 传入的元组结构要和表类型的列顺序、数量严格对应——你的StringTable只有一列，所以每个元组只能有一个元素

为什么直接传列表不行？因为普通列表在SQLAlchemy里会被当作普通参数处理，而MSSQL的表值参数需要明确告诉驱动「这是一个表类型的数据」，TableValuedParameter就是用来做这个格式转换的。

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