用途:为使用 Prisma Accelerate 或 Prisma Postgres(prisma:// 或 prisma+postgres:// URL)的用户提供升级到 Prisma v7 的迁移指引。
主要能力与要点:
- 明确禁止把 Accelerate URL 传给驱动适配器(如 PrismaPg),适配器需要直连数据库字符串,否则会失败。
- 正确配置:保留 Accelerate URL 于 .env;安装扩展 npm install @prisma/extension-accelerate;在 prisma.config.ts 中通过 env('DATABASE_URL') 配置 datasource;实例化客户端时使用 accelerateUrl 而非 adapter,并链式调用 $extends(withAccelerate())。
- 迁移命令:prisma migrate deploy 与 prisma db push 可直接使用 Accelerate URL;也可用 DIRECT_DATABASE_URL 提供直连供 CLI 使用。
- Prisma Postgres 云端数据库采用相同方式,使用 prisma+postgres:// URL。
- 缓存:扩展支持 cacheStrategy,可设置 ttl 与 swr。
- 边缘运行时:可在 Vercel Edge、Cloudflare Workers 等环境使用。
- 若改用直连 TCP,则从 accelerateUrl 切换为 adapter 并传入 postgres:// 直连串。
限制:资料未提供版本兼容细节、价格或性能数据。