关系型数据库
了解如何通过将 Prisma ORM 连接到你的数据库并生成用于数据库访问的 Prisma Client,来向现有的 Node.js 或 TypeScript 项目添加 Prisma ORM。以下教程将向你介绍 Prisma CLI、Prisma Client 和 Prisma 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
文件的目录(例如,frontend
、backend
等),请注意 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
文件,该文件用于定义环境变量(例如你的数据库连接)