关系型数据库(JavaScript 和 CockroachDB)
了解如何从头开始创建一个新的 Node.js 或 TypeScript 项目,方法是将 Prisma ORM 连接到您的数据库并生成一个用于数据库访问的 Prisma Client。本教程将向您介绍 Prisma CLI、Prisma Client 和 Prisma Migrate。
前提条件
为了成功完成本指南,您需要
- Node.js 安装在您的机器上(请参阅 系统要求 以了解官方支持的版本)
- 正在运行的 CockroachDB 数据库服务器
请参阅 系统要求 以了解确切的版本要求。
确保您手头有数据库 连接 URL。如果您没有正在运行的数据库服务器,只是想探索 Prisma ORM,请查阅 快速入门。
创建项目设置
作为第一步,创建一个项目目录并进入该目录
mkdir hello-prisma
cd hello-prisma
接下来,初始化一个 Node.js 项目并将 Prisma CLI 作为开发依赖项添加到其中
npm init -y
npm install prisma --save-dev
这会创建一个 package.json
文件,其中包含 Node.js 应用程序的初始设置。
您现在可以通过在 Prisma CLI 前添加 npx
来调用它
npx prisma
接下来,通过以下命令创建您的 Prisma Schema 文件来设置您的 Prisma ORM 项目
npx prisma init --datasource-provider postgresql --output ../generated/prisma
此命令会执行以下几项操作
- 创建一个名为
prisma
的新目录,其中包含一个名为schema.prisma
的文件,该文件包含带有数据库连接变量和模式模型的 Prisma Schema。 - 将
datasource
设置为PostgreSQL并分别将输出设置为自定义位置。 - 在项目的根目录中创建
.env
文件,该文件用于定义环境变量(例如您的数据库连接)
请注意,prisma init
创建的默认模式使用 PostgreSQL 作为 provider
。如果您没有使用 datasource-provider
选项指定提供程序,则需要编辑 datasource
块以改用 postgresql
提供程序
prisma/schema.prisma
datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
}