用途:该技能围绕 SQLAlchemy 2.0+ 的异步 ORM 用法,帮助在 Python 项目中定义类型安全的数据模型、组织异步会话并执行高效查询。
主要能力:包含异步引擎与会话工厂创建、基于 Mapped/mapped_column 的模型定义、Annotated 类型安全列、经典式模型、一对一/一对多/多对多关系、select 与条件过滤、selectinload/joinedload 预加载、分页、聚合统计、原始 SQL、写只读关系、自定义会话类、连接路由以及流式处理大结果集等模式。
使用方式:通过 uv add sqlalchemy[asyncio] 安装核心库,并按数据库选择驱动:uv add asyncpg、uv add aiosqlite 或 uv add aiomysql。数据库 URL 示例:PostgreSQL 为 postgresql+asyncpg://user:pass@localhost/db,SQLite 为 sqlite+aiosqlite:///database.db,MySQL 为 mysql+aiomysql://user:pass@localhost/db。迁移使用 Alembic:uv run alembic revision --autogenerate -m "Add users table" 生成迁移,uv run alembic upgrade head 应用迁移。与 FastAPI 集成时可用依赖注入方式提供会话。
适用场景:需要异步访问关系型数据库、希望模型具备类型标注、需要显式控制关系加载策略或进行数据库迁移的后端项目。
限制:资料未提供收费、价格、性能基准、版本兼容范围及具体平台支持等细节,这些信息暂未提供。