跳到主要内容

如何从 TypeORM 迁移到 Prisma ORM

简介​

本指南将向您展示如何将您的应用程序从 TypeORM 迁移到 Prisma ORM。我们将使用TypeORM Express 示例的扩展版本作为示例项目来演示迁移步骤。

本迁移指南使用 PostgreSQL 作为示例数据库，但也同样适用于Prisma ORM 支持的任何其他关系数据库。您可以在 Prisma ORM vs TypeORM 页面上了解 Prisma ORM 与 TypeORM 的比较。

前提条件​

在开始本指南之前，请确保您已拥有

  • 您想要迁移的 TypeORM 项目
  • 已安装 Node.js（16 或更高版本）
  • PostgreSQL 或其他受支持的数据库
  • 基本熟悉 TypeORM 和 Express.js

2. 准备迁移​

2.1. 了解迁移过程​

从 TypeORM 迁移到 Prisma ORM 的步骤始终相同，无论您构建的是哪种应用程序或 API 层

  1. 安装 Prisma CLI
  2. 内省您的数据库
  3. 创建基线迁移
  4. 安装 Prisma Client
  5. 逐步将您的 TypeORM 查询替换为 Prisma Client

这些步骤适用于您构建 REST API（例如，使用 Express、Koa 或 NestJS）、GraphQL API（例如，使用 Apollo Server、TypeGraphQL 或 Nexus）或任何其他使用 TypeORM 进行数据库访问的应用程序。

2.2. 设置 Prisma 配置​

创建一个新的 Prisma 架构文件

npx prisma init

使用您的数据库连接字符串更新 .env 文件中的 DATABASE_URL

DATABASE_URL="postgresql://USER:PASSWORD@HOST:PORT/DATABASE"

3. 迁移数据库架构​

3.1. 内省您的数据库​

运行 Prisma 的内省，从您现有的数据库创建 Prisma 架构

npx prisma db pull

这将创建一个包含您数据库架构的 schema.prisma 文件。

3.2. 创建基线迁移​

创建并应用基线迁移以标记您数据库的当前状态

npx prisma migrate diff --from-empty --to-schema-datamodel prisma/schema.prisma --script > baseline.sql
npx prisma migrate resolve --applied "baseline"

4. 更新您的应用程序代码​

4.1. 安装 Prisma Client​

安装 Prisma Client 包

npm install @prisma/client

生成 Prisma Client

npx prisma generate

4.2. 替换 TypeORM 查询​

开始使用 Prisma Client 替换您的 TypeORM 查询。以下是如何转换一些常见查询的示例

// Find one
const user = await userRepository.findOne({ 
  where: { id: 1 } 
});

// Create
const user = await userRepository.save({
  email: '[email protected]',
  name: 'Alice'
});

// Update
await userRepository.update(1, { 
  name: 'New name' 
});

// Delete
await userRepository.delete(1);

4.3. 更新您的控制器​

更新您的 Express 控制器以使用 Prisma Client。例如，以下是如何更新 CreateUserAction

import { prisma } from '../client'

export class CreateUserAction {
  async run(req: Request, res: Response) {
    const { email, name } = req.body
    
    const result = await prisma.user.create({
      data: {
        email,
        name,
      },
    })
    
    return res.json(result)
  }
}

5. 测试和部署​

5.1. 测试您的更改​

测试所有迁移的端点，以确保它们按预期工作

npm test

5.2. 部署您的更改​

  1. 部署您的架构更改
npx prisma migrate deploy
  1. 使用更新的依赖项部署您的应用程序代码。

后续步骤​

现在您已迁移到 Prisma ORM，您可以

  • 使用 Prisma 强大的查询 API 添加更复杂的查询
  • 设置 Prisma Studio 进行数据库管理
  • 实施数据库监控
  • 使用 Prisma 的测试实用程序添加自动化测试

有关更多信息和更新