跳到主要内容

关系型数据库

了解如何通过将 Prisma ORM 连接到你的数据库并生成用于数据库访问的 Prisma Client,来向现有的 Node.js 或 TypeScript 项目添加 Prisma ORM。以下教程将向你介绍 Prisma CLIPrisma ClientPrisma Introspection

提示

如果你正在从另一个 ORM 迁移到 Prisma ORM,请参阅我们的 TypeORM 迁移指南Sequelize 迁移指南

先决条件

为了成功完成本指南,你需要

  • 一个带有 package.json 的现有 Node.js 项目
  • Node.js 安装在你的机器上(请参阅 系统要求 以了解官方支持的版本)
  • 一个正在运行的 PlanetScale 数据库服务器和一个至少包含一个表的数据库

请参阅 系统要求 以了解确切的版本要求。

确保你手头有你的数据库 连接 URL(包含你的身份验证凭据)!如果你没有正在运行的数据库服务器并且只想探索 Prisma ORM,请查看 快速入门

设置 Prisma ORM

第一步,导航到包含 package.json 文件的项目目录中。

接下来,将 Prisma CLI 作为开发依赖项添加到你的项目中

npm install prisma --save-dev
注意

如果你的项目包含多个带有 package.json 文件的目录(例如,frontendbackend 等),请注意 Prisma ORM 专门设计用于 API/backend 层。要设置 Prisma,请导航到包含相关 package.json 文件的相应 backend 目录,并在那里配置 Prisma。

你现在可以通过在 Prisma CLI 前面加上 npx 来调用它

npx prisma
信息

请参阅 安装说明 以了解如何使用不同的包管理器安装 Prisma ORM。

接下来,通过使用以下命令创建你的 Prisma schema 文件模板来设置你的 Prisma ORM 项目

npx prisma init

此命令执行两项操作

  • 创建一个名为 prisma 的新目录,其中包含一个名为 schema.prisma 的文件,该文件包含带有你的数据库连接变量和 schema 模型的 Prisma schema
  • 在项目的根目录中创建 .env 文件,该文件用于定义环境变量(例如你的数据库连接)