关系型数据库

TypeScript

Prisma Postgres

了解如何从零开始创建一个新的 TypeScript 项目，该项目使用 Prisma Postgres 数据库。本教程向您介绍 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

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

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/