SQLAlchemy中VALUES子句不指定列名兼容SQLite的实现方法

方案1：构造无列名的VALUES子查询 #

SQLAlchemy默认要求给VALUES子句指定列名，但可以通过直接构造原生文本子查询绕过这个限制，让生成的SQL自动使用SQLite默认的column1、column2命名：

from sqlalchemy import text, select

# 构造VALUES子句的原生文本
values_clause = text("VALUES (1, 2), (2, 2), (3, 1)")
# 转为可查询的子表，不指定列名
pairs_subquery = values_clause.as_scalar().alias("pairs")

# 构建主查询
query = select(
    pairs_subquery.c.column1.label("element_id"),
    pairs_subquery.c.column2.label("variant_id"),
    products_elements.c.name.label("element_name"),
    elements_variants.c.name.label("variant_name")
).select_from(
    pairs_subquery.join(
        products_elements,
        products_elements.c.id == pairs_subquery.c.column1
    ).join(
        elements_variants,
        elements_variants.c.id == pairs_subquery.c.column2
    )
)

生成的SQL会完全匹配你需要的格式，无需额外列名定义，完美适配SQLite。

方案2：参数化原生SQL动态传入VALUES数据 #

如果更倾向于使用原生SQL，可通过参数化查询动态嵌入VALUES内容，同时避免SQL注入风险：

from sqlalchemy import text

# 定义带占位符的原生SQL
sql = """
SELECT pairs.column1 AS element_id,
    pairs.column2 as variant_id,
    products_elements.name as element_name,
    elements_variants.name as variant_name
FROM (
        VALUES :values_list
    ) AS pairs
    JOIN products_elements ON products_elements.id = pairs.column1
    JOIN elements_variants ON elements_variants.id = pairs.column2
"""

# 准备要传入的VALUES数据
values_data = [(1, 2), (2, 2), (3, 1)]

# 执行查询，SQLAlchemy会自动处理参数格式
result = conn.execute(text(sql), {"values_list": values_data})

注：SQLite配合SQLAlchemy最新版本可正常支持该参数格式，其他数据库兼容性需根据版本调整。

关键提示 #

• 使用text().as_scalar().alias()时，SQLAlchemy不会强制要求指定列名，会直接沿用数据库默认的列命名规则。
• 始终通过参数化方式传入VALUES数据，禁止手动拼接字符串，避免SQL注入漏洞。

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