关系型数据库

TypeScript

Prisma Postgres

学习如何从零开始创建一个带有 Prisma Postgres 数据库的新的 TypeScript 项目。本教程将向您介绍 Prisma CLI、Prisma Client 和 Prisma Migrate，并涵盖以下工作流程

• 从零开始在本地机器上创建 TypeScript 项目
• 创建一个 Prisma Postgres 数据库
• Schema 迁移和查询（通过 Prisma ORM）
• 连接池和缓存（通过 Prisma Accelerate）

先决条件

要成功完成本教程，您需要

• 一个(PDP) 账户
• 您的机器上安装 Node.js（请参阅 系统要求 了解官方支持的版本）（请参阅 系统要求 了解官方支持的版本）

创建项目设置

创建一个项目目录并进入该目录

mkdir hello-prisma
cd hello-prisma

接下来，初始化一个 TypeScript 项目并将 Prisma CLI 作为开发依赖项添加到其中

npm init -y
npm install prisma typescript tsx @types/node --save-dev

这将创建一个 package.json 文件，其中包含您的 TypeScript 应用的初始设置。

接下来，初始化 TypeScript

npx tsc --init

现在，您可以通过在其前面加上 npx 来调用 Prisma CLI。

npx prisma

接下来，使用以下命令创建您的 Prisma Schema 文件来设置您的 Prisma ORM 项目

npx prisma init --db --output ../generated/prisma

此命令执行以下几项操作

• 创建一个名为 prisma 的新目录，该目录包含一个名为 schema.prisma 的文件，该文件包含带有您的数据库连接变量和 schema 模型的 Prisma Schema。
• 将 output 设置为自定义位置。
• 在项目的根目录中创建一个 .env 文件，该文件用于定义环境变量（例如您的数据库连接和 API 密钥）。

在下一节中，您将学习如何将 Prisma Postgres 数据库连接到您刚刚在文件系统上创建的项目。

使用版本控制？

如果您正在使用像 git 这样的版本控制，我们建议您将一行添加到您的 .gitignore 文件中，以便从应用程序中排除生成的客户端。在此示例中，我们要排除 generated/prisma 目录。

.gitignore

generated/prisma/