用途:在 FastAPI 项目中实现生产可用的异步 SQLAlchemy 2.0+ 数据库模式,覆盖会话管理、迁移与性能优化。
主要能力:异步引擎与 async_sessionmaker 配置、FastAPI 依赖注入式会话(自动提交/回滚/关闭)、基础模型模板(UUID 主键、时间戳、软删除等 Mixin)、关系加载策略(selectinload、joinedload、subqueryload,规避 N+1)、CRUD 与聚合/子查询/窗口函数查询、嵌套事务与批量操作、连接池参数配置、Alembic 异步迁移、性能优化(批量插入更新、流式读取、索引)。
使用方式:通过 scripts/setup-alembic.sh 初始化 Alembic 异步配置,用 scripts/generate-migration.sh "说明" 生成迁移;参考 templates/ 下的 base_model.py、session_manager.py、alembic.ini、env.py 与 examples/ 下的示例文件落地实现。支持 PostgreSQL、MySQL、SQLite,异步驱动分别为 asyncpg、aiomysql、aiosqlite;版本 2.0+,技能版本 1.0.0。
适用场景:FastAPI 数据库模型实现、异步会话配置、迁移设置、查询性能优化、关系加载问题排查、连接池配置、事务管理、数据库架构迁移。
限制:仅给出模式与示例,未提供具体收费、价格与效果数据;自动生成的迁移需人工审查;使用 joinedload 时需调用 unique();具体部署与平台信息暂未提供。