SQLAlchemy如何无需额外查询即可通过关系引用已关联的父表

1. 推荐方案：直接使用继承自带的父表属性 #

你当前使用的是SQLAlchemy联合表继承模式，原生支持父表字段自动同步：查询Child对象时，SQLAlchemy会自动隐式JOIN父表CommonMetadata拉取全部父表字段，你额外定义的common_metadata关系完全多余，直接删除即可。
父表所有字段可以直接在Child实例上访问，不会触发任何额外查询：

child = session.query(Child).get(1)
# 直接访问父表字段，无额外SQL
print(child.data)

2. 特殊场景需要获取父类实例的方案 #

如果你确实有需求要拿到CommonMetadata类型的父对象实例，而非零散的字段，可选择以下两种方案：

方案A：利用Session一级缓存获取 #

同一Session上下文内，查询同ID的父对象会直接命中一级缓存，不会触发额外SQL：

child = session.query(Child).get(1)
# 无额外查询，直接复用缓存内的父表数据
common_metadata = session.get(CommonMetadata, child.id)

方案B：修改关系配置实现自动预加载 #

如果需要保留common_metadata属性，可以给关系增加lazy="joined"和viewonly=True配置，SQLAlchemy会在查询Child时自动关联加载父对象，访问属性时不会触发额外查询：

class Child(CommonMetadata):
    id = Column(Integer, ForeignKey("CommonMetadata.id"), primary_key=True)
    key = Column(String)
    # 修改后的关系配置
    common_metadata = relationship("CommonMetadata", lazy="joined", viewonly=True)

配置后直接访问child.common_metadata即可，不需要手动写JOIN逻辑。 #

常见问题说明 #

你之前手动执行join(CommonMetadata)报错的原因：联合表继承模式下，查询Child本身就会隐式JOIN父表CommonMetadata，手动再加JOIN会导致同表重复关联，触发别名重复错误。

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