SuperAPI AI 工具集

building-with-sqlalchemy-orm

数据与分析

查看项目

更新于 10-16 03:15

技能介绍

用途:面向教学与实现,帮助构建基于 SQLAlchemy ORM 2.0+ 与 PostgreSQL 的生产级数据库应用,并包含 Neon 无服务器场景的注意事项。

主要能力:以 Python 类定义数据表模型;用 Session 将操作组织为原子事务;通过 relationship() 与 ForeignKey 管理表间关系;使用 filter、order_by、join 等构造查询;配置 PostgreSQL/Neon 连接与连接池;提供 CRUD、事务回滚、聚合统计等示例;并说明如何将数据库操作封装为 MCP 工具供智能体调用。

使用方式:先收集代码库、学生用例与项目约定等上下文;定义模型后创建 engine 并调用 Base.metadata.create_all(engine);连接串从环境变量读取,格式为 postgresql+psycopg2://user:password@host/dbname?sslmode=require;事务用 try/except 包裹并显式 commit 或 rollback;生产环境配置 pool_size、max_overflow、pool_pre_ping 等参数。

适用场景:从需求构建数据库模型、实现安全 CRUD、管理外键与关联查询、连接 PostgreSQL 或 Neon、向初学者讲解持久化基础。

限制与安全要求:不得硬编码凭据,凭据应放入 .env;不得跳过事务错误处理;需校验用户输入;Neon 强制使用 ?sslmode=require;缺少依赖时可用 pip install sqlalchemy、pip install psycopg2-binary 或 uv add 对应包。具体价格、平台支持范围等资料暂未提供。