PythonORM教程_SQLAlchemy模型操作详解

12次阅读

sqlAlchemy的核心是模型,需继承Base并用column定义字段与主键;建表需显式调用create_all;数据操作通过session完成;关联关系由ForeignKey与relationship协同实现。

PythonORM教程_SQLAlchemy模型操作详解

SQLAlchemy 是 python 中最成熟、功能最丰富的 ORM 工具,模型(Model)是其核心——它把数据库表映射为 Python 类,让增删改查变成面向对象的操作。掌握模型定义、实例操作与关系管理,是用好 SQLAlchemy 的关键。

定义模型:继承 Base,声明字段和主键

模型类必须继承 declarative_base() 创建的基类,并通过 Column 显式声明字段类型、约束和主键。不写主键会报错;字符串字段推荐指定长度(如 String(50)),避免数据库兼容问题。

  • 导入必要组件:from sqlalchemy import create_engine, Column, Integer, String, DateTime
  • 创建基类:Base = declarative_base()
  • 定义模型:class User(Base): __tablename__ = ‘users’; id = Column(Integer, primary_key=True); name = Column(String(50)); email = Column(String(100), unique=True)

创建表与初始化数据库

模型定义后不会自动建表。需调用 Base.metadata.create_all(engine) 才会根据当前模型生成对应的数据表。这一步通常只在应用首次启动或测试环境执行,生产环境建议配合 Alembic 做迁移管理。

  • 创建引擎:engine = create_engine(‘sqlite:///app.db’)(支持 postgresqlmysql 等)
  • 建表:Base.metadata.create_all(engine)
  • 注意:如果表已存在,默认不会覆盖或修改结构;字段变更需手动处理或使用迁移工具

增删改查:Session 是操作入口

所有数据操作都通过 Session 实例完成。Session 是工作单元,负责跟踪对象状态、构建 SQL、提交事务。别直接操作连接或游标——这是 ORM 的意义所在。

立即学习Python免费学习笔记(深入)”;

  • 创建会话:from sqlalchemy.orm import sessionmaker; Session = sessionmaker(bind=engine); session = Session()
  • 新增:user = User(name=’Alice’, email=’a@example.com’); session.add(user); session.commit()
  • 查询:session.query(User).Filter(User.name == ‘Alice’).first()session.get(User, 1)(按主键查最快)
  • 更新:user.name = ‘Alicia’; session.commit()(修改后直接 commit,无需显式 update 调用)
  • 删除:session.delete(user); session.commit()

关联关系:用 relationship 和 ForeignKey 协同定义

一对多、多对一靠 ForeignKey 绑定外键列,再用 relationship 声明 Python 层的属性引用。关系字段不存数据,只提供便捷访问;真正存储依赖外键列。

  • 示例(用户有多个文章):class Article(Base): __tablename__ = ‘articles’; id = Column(Integer, primary_key=True); title = Column(String(200)); user_id = Column(Integer, ForeignKey(‘users.id’)); author = relationship(‘User’, back_populates=’articles’)
  • 反向关系别忘了在 User 类中加:articles = relationship(‘Article’, back_populates=’author’)
  • 加载策略可选:lazy=’joined’(立即联查)、lazy=’selectin’(批量 ID 查询)避免 N+1 问题
text=ZqhQzanResources