SQLAlchemy核心Table与ORM类差异及无法调用select方法问题咨询

两种映射方式的核心区别 #

SQLAlchemy的两种表映射分别属于不同的技术层，能力定位差异明显：

• 核心层Table对象：属于SQLAlchemy Core组件，是对数据库表的无业务封装的直接映射，仅存储表结构、字段、约束等元信息，原生属于SQL表达式体系，默认支持.select()、.insert()等DML方法直接生成SQL语句，适合轻量SQL操作、异步场景下直接配合异步数据库驱动使用，查询返回结果为原生行记录，不会做额外对象转换。
• 声明式ORM类：属于SQLAlchemy ORM组件，基于Core层的Table能力扩展实现，额外封装了对象映射、关系管理、会话事务等高级能力，默认会将查询结果自动转换为自定义ORM类的实例，方便做面向对象的业务逻辑开发。原生ORM类默认不直接暴露.select()方法，旧版本依赖Session.query()接口生成查询对象。

现有报错的原因 #

你遇到的AttributeError: 'Query' object has no attribute 'filter_by'报错，以及查询写法不生效的问题有两个核心诱因：

1. 接口误用：filter_by仅支持关键字参数的等值匹配（例如filter_by(nct_id="NCT123456")），in_这类复杂查询条件需要用filter方法传入表达式
2. 场景不匹配：你当前使用的是异步数据库执行方案（从await database.fetch_all用法可确认），同步场景下的Query对象本身不兼容异步执行逻辑，也没有绑定对应会话，属于用法不符合场景。

ORM类适配异步查询的修改方法 #

无需修改现有ORM类的字段定义，有两种可选方案适配你的异步查询场景：

方案1：直接使用SQLAlchemy原生select构造查询（推荐） #

SQLAlchemy 1.4及以上版本已经统一了Core和ORM层的查询语法，直接用全局的select方法即可构造ORM查询：

from sqlalchemy import select

# 构造ORM查询语句，语法和Core层几乎完全一致
stmt = select(Clinicaltrial).where(Clinicaltrial.uniprot_id.in_(uniprot_Ids))
# 执行异步查询
results = await database.fetch_all(stmt)
# 可选：将返回的行记录转换为ORM实例
orm_instances = [Clinicaltrial(**row._mapping) for row in results]

方案2：自定义基类让ORM类直接支持select方法 #

如果你希望和Core层Table对象的用法完全对齐，可以自定义声明基类扩展select方法：

from sqlalchemy import select
from sqlalchemy.ext.declarative import declarative_base

# 自定义基础模型类
class BaseModel:
    @classmethod
    def select(cls):
        return select(cls)

# 声明ORM基类时传入自定义的基础模型
Base = declarative_base(cls=BaseModel)
metadata = Base.metadata

# 原有Clinicaltrial类的定义无需修改，直接继承该Base即可
class Clinicaltrial(Base):
    __tablename__ = 'clinicaltrials'
    # 原有字段定义保持不变

修改后就可以直接用和Core层一致的写法查询：

select__filter = Clinicaltrial.select().filter(Clinicaltrial.uniprot_id.in_(uniprot_Ids))
return await database.fetch_all(select__filter)

内容的提问来源于stack exchange，提问作者夏溪辰