如何使用flask-SQLAlchemy查询SQL View并解决映射报错问题

结论 #

完全可以通过Flask-SQLAlchemy实现该需求，不需要更换工具，你遇到的报错是代码写法错误和ORM映射规则不熟悉导致的。

报错原因 #

你的报错核心有两个：

1. 列定义没有赋值给类属性：你写的db.Column("id", db.Integer, primary_key=True)没有赋值给类属性变量，SQLAlchemy扫描Model类的时候找不到你定义的主键列，自然抛出找不到主键的错误。
2. SQLAlchemy的ORM映射要求所有映射对象必须有至少一个主键标识，这个规则对视图和普通表都生效，只要你用Model类映射就需要遵守。

解决方案 #

提供两种常用实现方式，可根据你的使用习惯选择： #

方案1：继续用ORM Model映射（适合习惯用ORM语法查询的场景）

只需要修正Model的写法，把视图里的唯一标识列设为主键即可：

• 如果视图里有单个唯一非空列，直接给该列加primary_key=True参数，同时把列赋值给类属性
• 如果没有单个唯一列，把多个组合起来能唯一标识一行的列都设置primary_key=True，用复合主键即可

示例代码：

class MyView(db.Model):
    __tablename__ = "my_view_name_in_sql"
    # 列必须赋值给类属性，SQLAlchemy才能识别到
    id = db.Column(db.Integer, primary_key=True)
    sample_id = db.Column(db.String)
    # 其他视图字段按需添加
    
    # 可选配置：避免重复反射定义报错，不需要SQLAlchemy管理该表的创建/迁移
    __table_args__ = {
        'extend_existing': True
    }

定义完成后就可以像普通Model一样查询：

# 按id查询
view_item = MyView.query.get(1)
# 条件查询
view_list = MyView.query.filter_by(sample_id="xxx").all()

方案2：用SQLAlchemy Core直接查询（适合只读视图、不需要ORM特性的场景）

不需要定义Model类，直接反射视图结构后查询，写法更灵活：

# 反射获取视图对象
my_view = db.Table("my_view_name_in_sql", db.metadata, autoload_with=db.engine)
# 执行查询
results = db.session.execute(
    my_view.select().where(my_view.c.sample_id == "xxx")
).all()

两种方案都完全兼容Flask-SQLAlchemy的现有用法，不需要引入额外依赖。

内容的提问来源于stack exchange，提问作者Maximiliano Andres Friedl Schw