跳至主要内容

ORM 版本和成熟度级别

本页解释了 Prisma ORM 的发布流程，它的版本控制方式以及如何处理在整个发布过程中可能发生的重大更改。

版本​

Prisma ORM 版本通常每三周发布一次。请注意，这不是硬性规定 - 版本可能会因内部原因而推迟。

查看 GitHub 中的所有版本说明.

产品成熟度级别​

一个版本可以包含不同成熟度级别的产品或功能。成熟度级别描述了产品或功能的完整性和用户可以期望的重大更改。

注意：从版本 2.13.0 开始，'实验性' 不再是产品成熟度级别的一部分。

抢先体验​

如果一个功能或产品处于 **抢先体验** 状态

  • 我们已经验证了问题，并正在考虑解决方案，但不能确定该解决方案是否完整或是否完全适合。
  • 我们希望收集更多反馈，并根据需要调整解决方案，同时了解用户已准备好迎接重大的重大更改。

我们不建议在生产环境中使用抢先体验功能或产品。

预览​

如果一个功能或产品处于 **预览** 状态

  • 我们已经从方向和表面上验证了该功能或产品。
  • 用户可以依赖该功能或产品以及相关 API 基本上保持稳定，除非发布说明和文档中另有说明。
  • 没有已知的重大问题，尽管可能存在一些小错误。
  • 我们欢迎您就这些问题提供反馈，以便尽快使解决方案稳定下来。

预览通常在功能标志后面可用，或者需要某种形式的 opt-in（例如，通过在 CLI 中提供 --preview-feature 标志，或者 将它们添加到 Prisma 模式中 generator 块的 previewFeatures 属性中）。

我们不建议在生产环境中使用预览功能或产品。

另请参阅：所有当前可用的预览功能。

正式发布 (GA)​

如果一个功能或产品处于 **正式发布** 状态

  • 该解决方案已经测试了一段时间，我们收到了足够的反馈，认为它稳定并且可以投入生产使用。
  • 在 99% 的情况下应该没有错误（无法保证完全无错误的软件）。

版本控制​

Prisma ORM 的发布方案遵循语义版本控制 (SemVer)，从版本 3.x.x 开始。

Prisma ORM 和语义版本控制 (SemVer)​

SemVer 版本控制是如何工作的？​

语义版本控制 (SemVer) 使用以下规则进行版本升级（引自 SemVer 规范）

给定一个版本号 MAJOR.MINOR.PATCH，请递增

  1. MAJOR 版本，当您进行不兼容的 API 更改时，
  2. MINOR 版本，当您以向后兼容的方式添加功能时，并且
  3. PATCH 版本，当您进行向后兼容的错误修复时。

Prisma ORM 的版本控制如何遵循 SemVer？​

从版本 3.x.x 开始，Prisma ORM 严格遵循 SemVer 版本控制方案。

以下是 Prisma ORM 如何遵循 SemVer 的简要概述

  • 稳定表面（即 正式发布）中的重大更改仅在新的 MAJOR 版本中引入。
  • 重大更改仍然可以在 MINOR 中推出，但仅限于默认情况下未激活的 opt-in 预览和抢先体验功能（例如，通过预览功能标志或特定的 opt-in 选项或新的 CLI 命令）。
  • opt-in 重大更改（即预览和抢先体验）在 MINOR 中发布，仅在新的 MAJOR 版本中升级到正式发布（无需 opt-in）。

给定一个版本号 MAJOR.MINOR.PATCH，Prisma ORM 的版本号递增如下

  1. 当重大产品更新（具有重大更改）正式发布时，MAJOR 版本递增。
  2. 当发布添加向后兼容的新功能的产品更新时，MINOR 版本递增。如果功能具有重大更改，则仅当它们是 **opt-in** 时才能引入，即抢先体验和预览。
  3. 当修复功能错误时，PATCH 版本递增，并且始终 **向后兼容**。

注意：截至版本 2.28.0，Prisma ORM 并没有严格遵循 SemVer 版本控制。这意味着 2.MINOR.PATCH 范围内的版本，MINOR 版本可能包含重大更改。要了解有关 Prisma ORM 采用 SemVer 的更多信息，请查看 博客文章。