在 Bun 中使用 Prisma Postgres

注意 — 目前 Prisma 需要安装 Node.js 才能运行某些生成代码。确保在运行 bunx prisma 命令的环境中已安装 Node.js。

1. 创建新项目

   首先，创建一个目录并使用 bun init 初始化它。

   terminal

   mkdir prisma-postgres-app
   cd prisma-postgres-app
   bun init
   
2. 安装 Prisma 依赖项

   然后安装 Prisma CLI (prisma)、Prisma Client (@prisma/client) 和加速扩展作为依赖项。

   terminal

   bun add -d prisma
   bun add @prisma/client @prisma/extension-accelerate
   
3. 使用 PostgreSQL 初始化 Prisma

   我们将使用 bunx 与 Prisma CLI 初始化我们的模式和迁移目录。我们将使用 PostgreSQL 作为我们的数据库。

   terminal

   bunx --bun prisma init --db
   

   这将创建一个基本模式。我们需要更新它以使用新的无 Rust 客户端并针对 Bun 优化。打开 [prisma/schema.prisma] 并修改生成器块，然后添加一个简单的 User 模型。

   prisma/schema.prisma

   generator client {
   	provider = "prisma-client"
   	output = "./generated"
   	engineType = "client"
   	runtime = "bun"
   }
   
   datasource db {
   	provider = "postgresql"
   	url      = env("DATABASE_URL")
   }
   
   model User { 
   	id    Int     @id @default(autoincrement()) 
   	email String  @unique
   	name  String?
   } 
   
4. 配置数据库连接

   在 [.env] 文件中设置您的 Postgres 数据库 URL。

   .env

   DATABASE_URL="postgresql://username:password@localhost:5432/mydb?schema=public"
   
5. 创建并运行数据库迁移

   然后生成并运行初始迁移。

   这将在 prisma/migrations 中生成一个 .sql 迁移文件，并针对您的 Postgres 数据库执行迁移。

   terminal

   bunx --bun prisma migrate dev --name init
   

   从 .env 加载的环境变量
   从 prisma/schema.prisma 加载的 Prisma 模式
   数据源 "db": PostgreSQL 数据库 "mydb"，模式 "public" 位于 "localhost:5432"
   
   应用迁移 `20250114141233_init`
   
   根据新的模式更改创建并应用了以下迁移：
   
   prisma/migrations/
     └─ 20250114141233_init/
       └─ migration.sql
   
   您的数据库现在与您的模式同步。
   
   ✔ 在 18ms 内将 Prisma Client (6.17.1) 生成到 ./generated
   
6. 生成 Prisma Client

   正如输出所示，每当我们执行新迁移时，Prisma 都会重新生成我们的_Prisma 客户端_。客户端为从数据库读写提供了完全类型化的 API。您可以使用 Prisma CLI 手动重新生成客户端。

   terminal

   bunx --bun prisma generate
   
7. 使用 Accelerate 初始化 Prisma Client

   现在我们需要创建一个 Prisma 客户端实例。创建一个新文件 [prisma/db.ts] 以使用 Postgres 适配器初始化 PrismaClient。

   prisma/db.ts

   import { PrismaClient } from "./generated/client";
   import { withAccelerate } from '@prisma/extension-accelerate'
   
   export const prisma = new PrismaClient().$extends(withAccelerate())
   
8. 创建测试脚本

   让我们编写一个简单的脚本来创建一个新用户，然后计算数据库中的用户数量。

   index.ts

   import { prisma } from "./prisma/db";
   
   // 创建一个新用户
   await prisma.user.create({
     data: {
       name: "John Dough",
       email: `john-${Math.random()}@example.com`,
     },
   });
   
   // 计算用户数量
   const count = await prisma.user.count();
   console.log(`数据库中有 ${count} 个用户。`);
   
9. 运行并测试应用程序

   让我们使用 bun run 运行此脚本。每次运行时，都会创建一个新用户。

   terminal

   bun run index.ts
   

   数据库中有 1 个用户。
   

   terminal

   bun run index.ts
   

   数据库中有 2 个用户。
   

   terminal

   bun run index.ts
   

   数据库中有 3 个用户。
   

---

就是这样！现在您已经使用 Bun 设置了 Prisma Postgres，我们建议在继续开发应用程序时参考官方 Prisma Postgres 文档。