如何使用SQLAlchemy实现数据库的精确元组匹配查询？

你需要实现基于字段对元组的精确IN筛选，避免普通AND+IN组合导致的交叉匹配问题，SQLAlchemy完全支持这种写法，以下是具体实现方案：

问题背景 #

你希望用SQLAlchemy生成如下原生SQL：

SELECT first_name, age
FROM Customers
WHERE (first_name, age) in (('John', '31'),('Robert', '22'));

而之前使用的and_(Customers.name.in_(names), Customers.age.in_(ages))会返回像('John','22')这类不符合预期的交叉匹配结果——因为它只是分别匹配名字和年龄的集合，而非精确的字段对组合。

解决方案 #

方式一：使用tuple_函数（兼容SQLAlchemy 1.4及以上版本） #

通过sqlalchemy.tuple_构造字段元组，再调用in_方法传入目标字段对列表：

from sqlalchemy import select, tuple_
# 导入你的ORM模型和会话获取函数
from your_module import Customers, get_mariadb_session

with get_mariadb_session() as session:
    # 定义需要精确匹配的字段对列表
    target_pairs = [('John', 31), ('Robert', 22)]
    query = select(
        Customers.first_name, 
        Customers.age, 
        Customers.email
    ).where(
        tuple_(Customers.first_name, Customers.age).in_(target_pairs)
    )
    res = session.execute(query)
    # 遍历处理查询结果
    for row in res:
        print(row.first_name, row.age, row.email)

方式二：直接使用元组语法（SQLAlchemy 2.0+推荐） #

在SQLAlchemy 2.0及以上版本中，支持直接用模型字段组成元组，写法更简洁：

from sqlalchemy import select
from your_module import Customers, get_mariadb_session

with get_mariadb_session() as session:
    target_pairs = [('John', 31), ('Robert', 22)]
    query = select(
        Customers.first_name, 
        Customers.age, 
        Customers.email
    ).where(
        (Customers.first_name, Customers.age).in_(target_pairs)
    )
    res = session.execute(query)

效果说明 #

以上两种写法都会生成与你目标完全一致的原生SQL，确保只有(first_name, age)精确匹配目标列表中字段对的记录才会被返回，彻底避免交叉匹配的问题。

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