去年六月，我们推出了 Prisma 2.0 的第一个预览版本。今天，我们很高兴推出第一个正式 Beta 版，以及新的 网站 和更新的 Prisma 2.0 文档。
更新： Prisma 现在已准备好用于生产环境。请阅读公告文章以了解更多信息：Node.js 和 TypeScript 的完整 ORM。
目录
- 使用 Prisma Client 2.0 进行现代数据库访问
- 此版本包含哪些内容？
- 将
prisma2存储库重命名为prisma - 重命名
prisma2CLI - 我目前使用 Prisma 1；我该怎么办？
- 试用 Prisma 2.0 并分享您的反馈
TL;DR
- Prisma 2.0 Beta 版已准备就绪。凭借新的网站和文档，它现在是新开发人员开始使用 Prisma 的默认选择。
- Prisma 2.0 主要由 Prisma Client 组成，Prisma Client 是一个为 Node.js 和 TypeScript 自动生成且类型安全的查询构建器。Prisma Migrate 被认为是实验性的。
prisma/prisma2仓库已重命名为prisma/prisma（而以前的 Prisma 1 仓库prisma/prisma仓库现在称为prisma/prisma1）。
按照新文档中的 快速入门，在 5 分钟内试用新的 Prisma Client。
使用 Prisma Client 2.0 进行现代数据库访问
新版本的 Prisma Client 是一个适用于 Node.js 和 TypeScript 的现代数据库访问库。它可以替代传统的 ORM 和 SQL 查询构建器，用于在数据库中读取和写入数据。
要进行设置，您需要一个 Prisma schema 文件，并且必须将 Prisma Client 作为依赖项添加到您的项目中
Prisma Client 可以用于任何 Node.js 或 TypeScript 后端应用程序（包括无服务器应用程序和微服务）。这可以是 REST API、GraphQL API、gRPC API 或任何其他需要数据库的东西。
提高数据库工作效率
Prisma Client 的主要目标是提高应用程序开发人员在使用数据库时的效率。它通过提供一个干净的数据访问 API 来实现这一点，该 API 返回纯 JavaScript 对象。
这种方法可以更简单地推理数据库查询，并提高对可预测（和类型安全）查询结果的信心。以下是 Prisma Client 提供的一些主要优势
- 代码编辑器中的自动完成，而无需查找文档
- 以对象方式思考，而不是映射关系数据
- 类型安全的数据库查询，可以在编译时进行验证
- 单一数据源，用于数据库和应用程序模型
- 健康的约束，可防止常见的陷阱和反模式
- 使正确的事情变得容易的抽象（“成功之坑”）
- 查询而不是类，以避免复杂的模型对象
- 更少的样板代码，因此开发人员可以专注于应用程序的重要部分
在简介中了解有关 Prisma 如何提高开发人员效率的更多信息，或者通过查看网站上的代码示例来体验 Prisma Client API。
一个“智能”节点模块 🤓
@prisma/client 模块与“传统”节点模块不同。对于传统节点模块（例如，lodash），整个包都下载到您的 node_modules 目录中，并且仅在您重新安装该包时才会更新。
@prisma/client 节点模块是不同的。它是一个 “外观包”（基本上是一个存根），不包含任何功能代码。
虽然您确实需要使用 npm install @prisma/client一次安装它，但随着您不断改进应用程序，node_modules/@prisma/client 目录中的代码可能会更频繁地更改。这是因为每当您更改 Prisma schema 时，都需要重新生成 Prisma Client，这会更新 @prisma/client 节点模块中的代码。
由于 node_modules/@prisma/client 目录包含一些针对您的项目量身定制的代码，因此有时被称为“智能节点模块”
即使在纯 JavaScript 中也能获得自动完成和类型安全的好处
自动完成对于开发人员来说是一个极其强大的工具。它允许他们在编辑器中直接浏览 API，而无需查阅文档。Prisma Client 将自动完成功能带到您的数据库查询中！
得益于 Prisma Client 生成的类型，这些类型包含在 @prisma/client 模块的 index.d.ts 中，此功能不仅适用于 TypeScript 开发人员，也适用于使用纯 JavaScript 开发应用程序的开发人员。
部分数据库查询的类型安全
与其他 ORM 和数据库工具相比，Prisma Client 的一个主要优点是它提供了完全类型安全 - 即使对于“部分”数据库查询也是如此（即，当您仅查询模型的字段子集或包含关系时）。
例如，考虑以下 Prisma Client 查询（您可以切换选项卡以查看相应的 Prisma 模型）
请注意，生成的 usersWithPartialPosts 将静态类型化为
这意味着当您输入错误或意外访问数据库中未请求的属性时，TypeScript 会捕获任何错误！
开始使用
开始使用 Prisma Client 的最佳方法是按照文档中的 快速入门进行操作
快速入门（5 分钟）
或者，您可以
此版本包含哪些内容？
Prisma 2.0 Beta 版附带以下工具
- Prisma Client：适用于 Node.js 和 TypeScript 的自动生成、类型安全的查询构建器
- Prisma Migrate（实验性）：声明式 schema 迁移工具
- Prisma Studio（实验性）：用于查看和编辑数据库中数据的 GUI
按照新文档中的 快速入门，在 5 分钟内试用新的 Prisma Client。
注意：在发行说明中了解有关 Beta 版本的更多信息。
将 prisma2 存储库重命名为 prisma
自最初发布以来，Prisma 2.0 的主存储库一直被称为 prisma2。
由于 Prisma 2.0 现在是开发人员开始使用 Prisma 的默认选择，因此 Prisma 存储库已重命名如下
prisma/prisma2存储库已重命名为prisma/prismaprisma/prisma存储库已重命名为prisma/prisma1
重命名 prisma2 CLI
在预览期间，Prisma 2.0 的 CLI 是使用 prisma2 命令调用的。由于 Prisma 2.0 是新开发人员开始使用 Prisma 的默认选择，因此该命令已更改为仅 prisma。Prisma 1 的现有 prisma 命令已重命名为 prisma1。
另请注意，npm 包的安装方式已更改
| Prisma 版本 | 旧 CLI 命令 | 新 CLI 命令 | 旧 npm 包名称 | 新 npm 包名称 |
|---|---|---|---|---|
| 2.0 | prisma2 | prisma | prisma2 | @prisma/cli |
| 1.X | prisma | prisma1 | prisma | prisma1 |
给当前 Prisma 1 用户的注意事项
如果您当前正在使用带有 prisma 命令的 Prisma 1，则可以像以前一样继续使用它。如果您想升级到 Prisma 2.0，建议您卸载当前的 prisma 安装，并在需要它们的项目中本地安装新的 CLI 版本
prisma2 npm 包已弃用
prisma2 npm 包现已弃用。为防止安装期间出现混淆，现在当您尝试安装它时，它会输出以下内容
我目前使用 Prisma 1；我该怎么办？
首先，我们要衷心感谢所有现有的 Prisma 1 用户！🙏 我们非常感谢在 GitHub 和 Slack 上形成的这个支持性和活跃的社区！
Prisma 2.0 与 Prisma 1 相比如何？
与 Prisma 1 相比，Prisma 2.0 有许多更改。以下是 主要差异 的高级概述
- Prisma 2.0 不需要托管数据库代理服务器（即 Prisma 服务器）。
- Prisma 2.0 不再公开 “数据库的 GraphQL API”，但仅允许通过 Prisma Client API 进行编程访问。
- Prisma 2.0 使 Prisma 1 的功能更加模块化，并将其拆分为专用工具
- Prisma Client：Prisma client 1.0 的改进版本
- Prisma Migrate：数据建模和迁移（以前为
prisma deploy）。
- 更强大的内省功能允许将 Prisma 2.0 连接到任何现有数据库。
- Prisma 1 数据模型和
prisma.yml已合并到 Prisma schema 中。 - Prisma 2.0 使用自己的 建模语言，而不是基于 GraphQL SDL。
- 您可以使用 Nexus 或您选择的任何其他 GraphQL 库，通过 Prisma 构建 GraphQL 服务器。
如何访问 Prisma 1 文档？
您可以通过将版本号附加到 https://prisma.org.cn/docs 来继续访问特定版本的 Prisma 1 文档。例如，要查看 Prisma 1.34 版本的文档，您可以访问 https://v1.prisma.io/docs/1.34/。
Prisma 1 示例已移至 prisma1-examples 存储库。
我应该升级吗？
您是否应该升级取决于您的项目上下文。总的来说，一个主要的考虑因素是 Prisma Migrate 仍然是实验性的。这意味着您可能需要使用 SQL 或其他迁移工具对数据库 schema 进行任何未来的调整。
另请注意，我们将在未来几周内整理 升级指南以及专用工具，以进行升级过程。因此，如果您确实想在 Prisma Migrate 尚未准备就绪的情况下进行升级，那么等到这些资源到位可能值得。
我将 Prisma 1 与 Prisma client 和 nexus-prisma 一起使用，我应该升级吗？
当然可以升级在 Prisma 1 和 nexus-prisma 上运行的项目到 Prisma 2.0。
如果您决定升级，请注意，在升级到 Prisma 2.0 后更改数据库 schema 将需要使用 SQL 或第三方迁移工具运行迁移。另请注意，nexus-prisma API 会随 Prisma 2.0 更改。
以下是升级所需步骤的高级概述
- 在您的项目中安装 Prisma 2.0 CLI：
npm install @prisma/cli --save-dev - 创建一个 Prisma schema，其中包含指向您的 Prisma 1 数据库的
datasource - 内省您的 Prisma 1 数据库以获取您的数据模型：
npx prisma introspect - 安装 Prisma Client npm 包：
npm install @prisma/client - 生成 Prisma Client JS：
npx prisma generate - 升级到最新版本的
nexus-prisma并调整您的解析器。
注意：您可以在用于部署 Prisma 服务器的 Docker Compose 文件中找到您的数据库凭据。这些凭据是组成 Prisma 2.0 的 连接 URL 所必需的。
我将 Prisma 1 与 Prisma client（不带 nexus-prisma）一起使用，我应该升级吗？
当然可以升级在 Prisma 1 上运行的项目。
如果您决定升级，请注意，在升级到 Prisma 2.0 后更改数据库 schema 将需要使用 SQL 或第三方迁移工具运行迁移。以下是升级所需步骤的高级概述
- 导航到您的项目目录
- 在您的项目中安装 Prisma 2.0 CLI：
npm install @prisma/cli --save-dev - 创建一个 Prisma schema，其中包含指向您的 Prisma 1 数据库的
datasource - 内省您的 Prisma 1 数据库以获取您的数据模型：
npx prisma introspect - 安装 Prisma Client npm 包：
npm install @prisma/client - 生成 Prisma Client JS：
npx prisma generate - 将您之前使用的 Prisma client 1.0 更新为新的 Prisma Client 2.0
注意：您可以在用于部署 Prisma 服务器的 Docker Compose 文件中找到您的数据库凭据。这些凭据是组成 Prisma 2.0 的 连接 URL 所必需的。
我将 Prisma 1 与 prisma-binding 一起使用，我应该升级吗？
当然可以升级在 Prisma 1 和 prisma-binding 上运行的项目到 Prisma 2.0。
如果您决定升级，请注意，在升级到 Prisma 2.0 后更改数据库 schema 将需要使用 SQL 或第三方迁移工具运行迁移。
另请注意，Prisma 2.0 更改了 GraphQL 解析器的实现方式。由于 Prisma 2.0 没有为您的数据库公开 GraphQL API，因此您不能再使用 prisma-binding npm 包。这主要与实现关系有关，这些关系的解析器现在需要在类型级别上实现。要了解更多关于为什么这是必要的，请务必阅读这篇关于 GraphQL schema 基础知识的文章。
以下是升级所需步骤的高级概述
- 在您的项目中安装 Prisma 2.0 CLI：
npm install @prisma/cli --save-dev - 创建一个 Prisma schema，其中包含指向您的 Prisma 1 数据库的
datasource - 内省您的 Prisma 1 数据库以获取您的数据模型：
npx prisma introspect - 安装 Prisma Client npm 包：
npm install @prisma/client - 生成 Prisma Client JS：
npx prisma generate - 调整您的解析器以使用 Prisma Client 而不是
prisma-binding
如果您想切换到 代码优先 方法，请查看 GraphQL Nexus。
注意：您可以在用于部署 Prisma 服务器的 Docker Compose 文件中找到您的数据库凭据。这些凭据是组成 Prisma 2.0 的 连接 URL 所必需的。
试用 Prisma 2.0 并分享您的反馈
我们非常兴奋能够最终分享 Prisma 2.0 的 Beta 版本，并且迫不及待地想看看大家用它构建什么。
开始使用 Prisma 2.0
如果您想留下反馈、分享想法、创建功能请求或提交错误报告，请在（已重命名的）GitHub 上的 prisma 存储库中进行，并加入（已重命名的）#prisma2-beta Slack 频道 Prisma Slack！
不要错过下一篇文章！
注册 Prisma 新闻通讯
