Prisma 爱之初体验：一款非常棒的 ORM 工具库

萌萌哒草头将军

发布于 2025-04-09 13:13:32

21500

代码可运行

文章被收录于专栏：前端框架前端框架

运行总次数：0

代码可运行

前言最近开发过程中接触到了 `Prisma`，所以今天就整理了下 `Prisma` 使用过程，希望可以帮助快速上手并应用到实际项目中。

正文

安装与初始化

首先安装 Prisma CLI 和 Prisma Client：

npm install prisma --save-dev
npm install @prisma/client

然后执行初始化命令：

npx prisma init

初始化后项目中会生成以下文件结构：

prisma/
  schema.prisma    # 模型定义文件
.env               # 数据库连接配置

配置数据库

打开 schema.prisma，配置数据库连接信息，例如使用 PostgreSQL：

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

接着在 .env 文件中写入实际连接字符串：

DATABASE_URL="postgresql://user:password@localhost:5432/mydb"

定义数据模型

在 schema.prisma 文件中添加模型定义，比如用户和文章模型：

model User {
  id    Int     @id @default(autoincrement())
  email String  @unique
  name  String?
  posts Post[]
}

model Post {
  id        Int     @id @default(autoincrement())
  title     String
  content   String?
  published Boolean @default(false)
  author    User    @relation(fields: [authorId], references: [id])
  authorId  Int
}

执行数据库迁移

运行迁移命令，将模型同步到数据库中：

npx prisma migrate dev --name init

每次修改模型后都应执行新的迁移命令。

使用 Prisma Client

修改完模型后需要重新生成客户端：

npx prisma generate

然后就可以开始数据库操作了：

import { PrismaClient } from'@prisma/client'

const prisma = new PrismaClient()

// 创建用户
const user = await prisma.user.create({
  data: {
    email: 'alice@example.com',
    name: 'Alice',
  },
})

// 查询所有用户
const users = await prisma.user.findMany()

// 更新用户
await prisma.user.update({
  where: { email: 'alice@example.com' },
  data: { name: 'Alicia' },
})

// 删除用户
await prisma.user.delete({
  where: { email: 'alice@example.com' },
})

高级功能

关联查询

// 查询用户及其文章
const usersWithPosts = await prisma.user.findMany({
  include: { posts: true },
})

嵌套写入

await prisma.user.create({
  data: {
    email: 'bob@example.com',
    name: 'Bob',
    posts: {
      create: {
        title: 'Hello World',
      },
    },
  },
})

过滤、排序与分页

// 过滤已发布文章
await prisma.post.findMany({
  where: { published: true },
})

// 排序用户
await prisma.user.findMany({
  orderBy: { name: 'asc' },
})

// 分页查询
await prisma.post.findMany({
  skip: 10,
  take: 5,
})

可视化管理：Prisma Studio

npx prisma studio

启动后你可以在浏览器中直观地查看和编辑数据库数据，非常适合开发调试。

最佳实践

单例 Prisma Client

防止在热更新或函数中重复创建 PrismaClient：

// lib/prisma.ts
import { PrismaClient } from '@prisma/client'

const prisma = global.prisma || new PrismaClient()
if (process.env.NODE_ENV !== 'production') global.prisma = prisma

export default prisma

安全关闭连接

process.on('beforeExit', async () => {
  await prisma.$disconnect()
})

批量操作

await prisma.$transaction([
  prisma.user.create({ data: { name: 'Alice' } }),
  prisma.post.create({ data: { title: 'Hello' } }),
])

与 GraphQL 的结合

如果项目中使用 Apollo Server，可以直接在 resolver 中使用 Prisma 操作数据库：

const resolvers = {
  Query: {
    users: () => prisma.user.findMany(),
    user: (_, args) => prisma.user.findUnique({ where: { id: Number(args.id) } }),
  },
  User: {
    posts: (parent) => prisma.user.findUnique({ where: { id: parent.id } }).posts(),
  },
}