跳到主要内容

如何升级

概述

本页帮助您就何时以及如何从 Prisma 1 升级到 Prisma ORM 2.x 及更高版本做出明智的决定。

升级文档

升级文档由几个页面组成,以下是如何使用它们的概述

  • 如何升级您在此处):了解总体升级过程的起点。
  • 模式不兼容性:关于 Prisma 1 和 Prisma ORM 2.x(及更高版本)之间模式不兼容性的参考页面。阅读此页是可选的,但它将使您更好地理解升级过程中的某些步骤。

除了这两个页面外,还有各种实战指南,它们将引导您完成升级过程的示例场景

  • 升级 Prisma 层:无论您的 Prisma 1 设置如何,您都应该始终通过遵循本指南来启动您的升级过程

完成该指南后,您可以选择以下四个指南之一来升级您的应用层

  • 旧版到新版 Nexus:如果您当前使用 GraphQL Nexus 运行 Prisma 1,请选择此指南。
  • prisma-binding 到 Nexus:如果您当前使用 prisma-binding 运行 Prisma 1 并且想要升级到 Nexus,请选择此指南。
  • prisma-binding 到 SDL 优先:如果您当前使用 prisma-binding 运行 Prisma 1 并且想要升级到 SDL 优先 GraphQL 服务器,请选择此指南。
  • REST API:如果您当前使用 Prisma Client 1 运行 Prisma 1 并且正在构建 REST API,请选择此指南。

Prisma 1 和 Prisma ORM 2.x 及更高版本之间的主要区别

从高层来看,Prisma 1 和 Prisma ORM 2.x 及更高版本之间的最大区别总结如下。

Prisma ORM 2.x 及更高版本

  • 不需要托管数据库代理服务器(即Prisma 服务器)。
  • 使 Prisma 1 的功能更加模块化,并将其拆分为专用工具
    • Prisma 客户端:Prisma 客户端 1.0 的改进版本
    • Prisma Migrate:数据建模和迁移(以前的 prisma deploy)。
  • 使用Prisma 模式,它是 Prisma 1 数据模型和 prisma.yml 的合并。
  • 使用自己的建模语言,而不是基于 GraphQL SDL。
  • 不再暴露“数据库的 GraphQL API”,而只允许通过 Prisma 客户端 API 进行程序化访问
    • 不再支持 Prisma ORM 绑定。
  • 允许通过更强大的内省将 Prisma ORM 2.x 及更高版本连接到任何现有数据库

特性对等

Prisma ORM 2.x 及更高版本尚未完全具有与 Prisma 1 的特性对等性。Prisma ORM 2.x 及更高版本仍然缺少的最大特性是实时订阅。

  • 实时 API(订阅):Prisma ORM 2.x 及更高版本目前没有办法订阅数据库中发生的事件并实时收到通知。目前尚不清楚实时 API 是否、何时以及以何种形式添加到 Prisma ORM 2.x 及更高版本中。目前,您可以使用本机数据库触发器来实现实时功能,或者如果您使用 GraphQL 订阅,您可以考虑在mutation 解析器中手动触发订阅。

模式不兼容性

在 Prisma 1 中运行 prisma deploy 时创建的数据库模式仅与 Prisma ORM 2.x 及更高版本创建的数据库模式部分兼容。本节简要概述了常见的不兼容性以及潜在的解决方法。-

注意:有关问题和相应解决方法的详细说明,请参阅模式不兼容性页面。

以下是不同列的概述

  • 问题:从 Prisma 1 升级到 Prisma ORM 2.x 及更高版本时的问题简短描述
  • SQL:可以通过对 SQL 模式进行非破坏性更改来解决此问题吗?
  • Prisma 模式:可以通过对 Prisma ORM 2.x 及更高版本中的模式进行非破坏性更改来解决此问题吗?
  • 破坏 Prisma 1:SQL 语句是否破坏 Prisma 1 设置?这仅在您选择逐步并行升级策略时相关。
问题SQLPrisma 模式破坏 Prisma 1
默认值未在数据库中表示
生成的 CUID 作为 ID 值未在数据库中表示
@createdAt 未在数据库中表示
@updatedAt 未在数据库中表示
内联 1-1 关系被识别为 1-n(缺少 UNIQUE 约束)
所有非内联关系都被识别为 m-n
Json 类型在数据库中表示为 TEXT否(MySQL)
是(PostgreSQL)
枚举在数据库中表示为 TEXT否(MySQL)
是(PostgreSQL)
必需的 1-1 关系未在数据库中表示
Prisma 1 中的 @db 属性未传输到 Prisma 模式
CUID 长度不匹配
标量列表(数组)使用额外的表进行维护取决于取决于

注意:Prisma 模式中解决方法的常见缺点是,在重新内省数据库后,对 Prisma 模式的更改会丢失,并且每次内省运行后都需要手动重新添加。

Prisma 1 升级 CLI

Prisma CLI introspection flow

Fixing the schema incompatibilities