SuperAPI AI 工具集

prisma-next-queries

通用与其它

查看项目

更新于 10-16 07:20

技能介绍

用途:在数据契约已生成、数据库已就绪后,处理数据的读取、写入、更新、删除、关联预加载、聚合等操作。

主要能力:同一 db 值提供两条查询通道——ORM 与下层 SQL 构建器,可选其一。支持 include/eager load、分页、排序、过滤、投影,Postgres 与 SQLite 支持 db.transaction(...) 事务,支持 count/sum/avg 等聚合。多命名空间契约可用 db.orm.<命名空间>.<Model>、db.sql.<命名空间>.<table> 定位。

使用方式:先读 src/prisma/db.ts 确认目标(@prisma-next/postgres/runtime 或 @prisma-next/mongo/runtime),再加载对应 postgres.md 或 mongo.md。Postgres 用 PascalCase 模型根(db.orm.User)与 db.sql.user;Mongo 用复数小写根(db.orm.users)与 db.query.from('users'),两者不可混用。.all() 返回 AsyncIterableResult<Row>,可直接 await 得到数组;需要真正 Promise 时用 .toArray(),超大结果可 for await 流式消费。结果单次消费,重复消费抛 RUNTIME.ITERATOR_CONSUMED,应缓存到变量复用。短脚本结束调用 await db.close() 以便进程退出。

适用场景:数据增删改查、关联查询、分页排序过滤、聚合统计、事务包装。

限制:尚不支持 N:M 的 .include() 与嵌套变更;Postgres 外观暂不提供 and/or/not 组合器;分组聚合不支持 .orderBy/.take;无 raw-SQL 通道、无 TypedSQL、无 .explain()、无 .stream();不支持多语句批量事务;Mongo 外观无事务、无 ORM 聚合、过滤辅助未全部导出;无自动 N+1 检测。部分文档细节暂未提供。