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

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')(支持 PostgreSQL、MySQL 等)
- 建表: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 问题










