Flask-SQLAlchemy中如何正确管理SQL视图并将其映射为数据模型？

现有实现的合理性 #

你当前的写法可以正常完成视图查询的基础需求，但存在两个明显缺陷：

1. Flask-SQLAlchemy默认将所有继承db.Model的类识别为普通数据表，使用flask-migrate生成迁移脚本时会自动生成该模型的建表语句，和你预先创建的视图冲突
2. 没有做只读限制，业务代码中如果不小心对视图模型执行增删改操作并提交，会直接触发数据库层面的报错

最佳实践方案 #

1. 标记视图模型，和普通表做明确区分 #

给视图模型增加__table_args__参数，添加自定义标记识别这是视图，业务代码中也可以通过该标记快速区分表和视图：

class AccountView(db.Model):
    # 自定义标记该对象为视图，不是普通表
    __table_args__ = {'info': dict(is_view=True)}
    
    username = db.Column(db.String(13), primary_key=True)
    address = db.Column(db.String(255), primary_key=True)

2. 过滤迁移脚本中的视图建表逻辑 #

如果使用flask-migrate管理表结构，修改迁移配置文件migrations/env.py，添加视图过滤逻辑，避免自动生成视图的建表语句：

def include_object(object, name, type_, reflected, compare_to):
    # 过滤掉标记为视图的表，不生成迁移逻辑
    if type_ == "table" and object.info.get("is_view", False):
        return False
    return True

3. 手动编写视图的创建/删除迁移脚本 #

视图的创建和删除无法靠自动迁移生成，需要手动创建迁移文件，写入对应SQL：

def upgrade():
    op.execute("""
    CREATE VIEW [AccountView] AS
    SELECT [Account].[username]
            ,[Address].[address]
    FROM [Account]
    INNER JOIN [Address] ON [Account].[username] = [Address].[username]
    """)

def downgrade():
    op.execute("DROP VIEW [AccountView]")

4. 增加只读限制（可选，推荐） #

可以按需选择两种只读限制方案：

• 方案一：单个视图禁用增删改方法

class AccountView(db.Model):
    __table_args__ = {'info': dict(is_view=True)}
    
    username = db.Column(db.String(13), primary_key=True)
    address = db.Column(db.String(255), primary_key=True)

    def save(self):
        raise Exception("当前为只读视图，不可修改")
    
    def delete(self):
        raise Exception("当前为只读视图，不可删除")

• 方案二：全局监听flush事件，禁止所有视图的修改操作，适合多视图的项目

from sqlalchemy import event
from sqlalchemy.orm import Session

@event.listens_for(Session, 'before_flush')
def prevent_view_modification(session, flush_context, instances):
    for obj in session.new.union(session.dirty).union(session.deleted):
        if obj.__table__.info.get("is_view", False):
            raise ValueError(f"视图 {obj.__tablename__} 为只读，不可执行增删改操作")

额外说明 #

视图的数据同步是数据库原生能力，不需要你在Python代码中做任何额外处理，每次查询AccountView时，数据库会自动关联最新的Account和Address表数据返回，ORM层的查询操作和普通表完全一致，可以直接使用AccountView.query.filter()等标准ORM语法查询。

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