SuperAPI AI 工具集

advanced-alchemy-getting-started

编程与开发

查看项目

更新于 10-15 16:48

技能介绍

用途:在新建或现有 Python 服务中引入 Advanced Alchemy,完成从安装到首个可运行 CRUD 路径的基础搭建。

前置条件:Python 3.9+、SQLAlchemy 2.x,并先确认项目需要同步还是异步数据库访问。

安装:安装 advanced-alchemy;若需要数据库迁移命令,则安装 advanced-alchemy[cli]。

配置选择:异步使用 SQLAlchemyAsyncConfig 搭配 AsyncSessionConfig,同步使用 SQLAlchemySyncConfig 搭配 SyncSessionConfig,配置类需与驱动和执行方式匹配。示例: from advanced_alchemy.config import AsyncSessionConfig, SQLAlchemyAsyncConfig alchemy_config = SQLAlchemyAsyncConfig( connection_string="sqlite+aiosqlite:///app.db", session_config=AsyncSessionConfig(expire_on_commit=False), create_all=True, )

实施规则:先采用最小可用配置,再添加服务层、框架辅助或多绑定;会话配置保持显式,请求驱动应用尤其注意 expire_on_commit=False;同步与异步在每个集成边界只选一次,避免随意混用;先让首个 CRUD 路径端到端可运行,再引入迁移、种子数据或自定义类型。

验证清单:确认配置类与驱动、执行风格一致;确认元数据创建或迁移能看到与运行时相同的模型;确认仓储或服务能打开会话并完成一次基本读写;确认底层 SQLAlchemy 可用后再做框架集成。

相关技能:建模用 advanced-alchemy-modeling;CRUD 可用后接 advanced-alchemy-repositories 与 advanced-alchemy-services;框架接入用 advanced-alchemy-litestar、advanced-alchemy-fastapi 或 advanced-alchemy-flask;基础稳定后再用 advanced-alchemy-cli 与 advanced-alchemy-database-seeding。

限制:资料未提供具体版本兼容矩阵、性能数据或收费信息。