Python/SQLAlchemy中使用列表作为SQL参数报错求助

问题根源 #

你手动拼接?占位符的方式存在两个核心问题：

1. 当customer_exclude_list为空时，会生成NOT IN ()这种无效SQL语法，直接触发DBAPI错误；
2. 结合SQLAlchemy引擎使用pandasread_sql时，位置占位符的参数传递逻辑和pyodbc驱动的适配性不佳，导致参数解析异常，控制台重复显示列表就是这个原因。

修正方案 #

用SQLAlchemy的text对象构建查询，通过命名参数绑定列表，同时处理空列表的边界情况：

from sqlalchemy import text
import pandas as pd
import sqlalchemy

# 创建数据库引擎
conx = sqlalchemy.create_engine("mssql+pyodbc://UID:PW@SERVERNAME/DB?driver=ODBC+Driver+17+for+SQL+Server", echo=False)

customer_exclude_list = ["客户A", "客户B"]  # 你的排除列表

# 处理空列表的特殊情况
if not customer_exclude_list:
    query = text("""
        select distinct customer
        from customer_table
    """)
    df = pd.read_sql(sql=query, con=conx)
else:
    # 用命名参数绑定列表，SQLAlchemy自动适配数据库占位符
    query = text("""
        select distinct customer
        from customer_table
        where customer NOT IN :exclude_list
    """)
    # 列表转元组，确保SQLAlchemy正确解析可迭代参数
    df = pd.read_sql(sql=query, con=conx, params={"exclude_list": tuple(customer_exclude_list)})

关键说明 #

• text对象会自动根据数据库驱动转换占位符格式（比如pyodbc需要的?），不需要手动拼接，彻底避免语法错误；
• 命名参数比位置占位符更清晰，也能避免参数顺序混乱的问题；
• 空列表必须单独处理，因为SQL语法不允许NOT IN ()这种写法，此时直接查询所有数据即可。

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