database-access 是 berriai/litellm 项目中的一项数据库访问技能,主要面向在该代码库中进行数据库相关开发的场景。它的核心目标是把数据库访问行为收敛到明确的仓储层,并为后续从 Prisma 迁移到 Rust 实现提供受控的路径。
用途与原则
技能针对三类任务给出规则:新增数据库访问、把现有 Prisma 调用提取到仓储、以及显式要求将查询移植到 Rust 与 SQLx。
新增数据库访问时,Python 侧应通过 litellm/repositories 中的操作暴露数据库能力,调用方获得类型化输入和输出,而不是 Prisma 客户端、模型或查询字典。查询执行与后端选择保留在仓储内部。实现可以使用 Prisma,新增一个查询并不要求同时做 Rust 移植。原生 Rust 调用方则直接使用 litellm-rust/crates/db。
提取现有访问到仓储
当被要求把已有访问移动到仓储后面时,需先识别要移动的调用及其事务边界,把现有 Prisma 实现搬入相应仓储,并将直接数据库调用替换为仓储操作。过程中要保留返回值、错误和事务行为,并配合聚焦的回归测试。该操作定位于提取而非后端迁移或无关清理。若已存在等价的 Rust 或 SQLx 查询,应保持不变,除非明确要求集成;等价查询的存在本身不构成把 Prisma 调用方切换到 Rust 的理由,仓储提取即使在 Rust 查询可用时也可以继续使用 Prisma。
移植到 Rust 或 SQLx
当被要求把 Prisma 查询移植到 Rust 或 SQLx 时,先确认现有输入、输出、错误与事务边界,并在 litellm-rust/crates/db 中查找可复用的等价查询;行为匹配则复用。否则遵循 litellm-rust/crates/db/AGENTS.md 的约定:静态 SQL 放入 queries/ 并用 SQLx 编译检查,类型化输入和可复用行投影放在 src/,SQL 变更后刷新 SQLx 查询元数据;Python 转换留在 Python 桥接层,而不是数据库 crate 中。若要求接入调用方,则通过桥接层暴露 Rust 操作并从仓储调用。仅移植查询可以在不切换调用方的情况下落地;在切换调用方前需针对真实 PostgreSQL 验证行为,检查空值处理、冲突、排序、错误和事务语义,只有在没有调用方需要旧实现时才移除它。
迁移边界与限制
长期方向是先把 Python 数据库访问集中到仓储,再用 Rust API 逐步替换 Prisma 实现;过渡期允许 Prisma 与 Rust 混合,无关的既有调用可以保持原样。两种后端可能通过 PgBouncer 各自拥有连接池,需要一起调整大小并验证连接池模式兼容性。PgBouncer 不会在 Prisma 与 SQLx 之间共享事务,因此每个原子工作单元必须留在单一后端和事务内;若 Rust 写入失败但可能已经提交,绝不能再用 Prisma 重试。当前 Prisma 负责模式迁移,SQLx 迁移归属与移除 Prisma 是独立的计划步骤,不属于查询移植的一部分。