SuperAPI AI 工具集

prisma-next-runtime

通用与其它

查看项目

更新于 10-16 07:20

技能介绍

Prisma Next — Runtime(db.ts 接线)技能,用于把已生成的契约产物与查询运行时连接起来。适用场景:首次编写 db.ts、添加中间件(telemetry、lints、budgets、自定义)、按环境配置(开发与生产)、在 Postgres/SQLite/Mongo façade 之间切换、使用事务、以及编写一次性脚本时处理连接关闭。不适用:编写查询、Supabase 角色工厂、编辑契约、构建工具集成或调试运行时错误,这些各有独立技能。

核心概念:db.ts 是运行时入口,导入 @prisma-next/<target>/runtime 的默认导出工厂、Contract 类型(contract.d.ts)与 contract.json。工厂签名形如 postgres<Contract>(options),Contract 类型参数决定静态查询界面的类型推断。工厂为惰性连接:db.sql、db.orm 立即可用,驱动/连接池在首次需要运行时或显式调用 db.connect({ url }) 时创建。

基本用法:从对应 façade 导入工厂,传入 contractJson 与可选 url,导出 db 供应用其余部分引用。导入 JSON 需要 with { type: 'json' } 导入属性。中间件按数组顺序组合,靠前者在外层包裹。连接配置支持 url、自建 pg 连接池或 binding 三种互斥形式,池调优使用 poolOptions.connectionTimeoutMillis / idleTimeoutMillis。

脚本中若进程查询后不退出,需在返回前 await db.close(),或使用 await using 在模块退出时自动释放;await using 是块级作用域,不可放入请求处理器。服务器模式应使用模块级单例,稳态下不调用 close()。close() 幂等且不可逆,不会中止进行中的查询,也不会释放用户自建的连接池。db.end() 不存在。

其他能力:Postgres 与 SQLite 支持 db.transaction(fn),回调内使用 tx.sql / tx.orm;Mongo façade 不提供事务。lints 与 budgets 位于 @prisma-next/sql-runtime,尚未从 postgres façade 再导出;telemetry 需单独安装 @prisma-next/middleware-telemetry。更完整的中间件选项以源码为准。具体平台支持范围、限制与后续变化暂未提供。