SqlAlchemy使用relationship关联时如何选择查询指定列

报错原因 #

该报错是因为relationship是ORM层定义的关联逻辑，不属于对应数据库表的原生物理列，不能直接作为独立字段传入query()方法。db.query(models.Parent.id, models.Parent.children)的写法会让SQLAlchemy尝试到parent表中查找名为children的列，自然无法匹配。

解决方案 #

根据使用场景可选择以下两种实现方式：

方案1：返回ORM实体对象（仅加载指定字段） #

适用于需要保留ORM对象使用习惯的场景，通过SQLAlchemy加载策略控制加载的字段范围，避免冗余数据查询：

1. 导入加载工具

from sqlalchemy.orm import load_only, selectinload

2. 执行查询

parent = db.query(models.Parent).options(
    # 指定Parent表仅加载id字段，未指定字段访问时会触发懒查询
    load_only(models.Parent.id),
    # 控制关联children仅加载指定字段，*selectinload适合一对多关联，可避免产生笛卡尔积*
    selectinload(models.Parent.children).load_only(models.Child.id, models.Child.parent_id)
).first()

使用说明：

• 可直接通过parent.id获取主表指定字段值
• 可直接通过parent.children获取关联的Child对象列表，列表中每个Child仅加载指定字段

方案2：返回自定义聚合结构（无需ORM实例） #

适用于不需要完整ORM对象，仅需要返回指定字段+关联数据的场景，通过关联查询+聚合函数实现：

from sqlalchemy import func

# 示例返回parent id + 所有关联child的id列表，可根据需求调整聚合的child字段
result = db.query(
    models.Parent.id,
    func.array_agg(models.Child.id).label("child_ids")
).join(models.Parent.children).group_by(models.Parent.id).first()

返回的result为二元组，第一个元素为Parent的id值，第二个元素为所有关联Child的id组成的列表。 #

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