Prisma 数据管理指南（以及一些魔法）

Prisma 简介：简化数据管理 ✨

Prisma 是使用 Node.js 管理数据库的神奇工具，让你不再为数据库操作而烦恼！🧙‍♂️ 忘掉那些让你头疼的老式 ORM 吧。Prisma 快速、简单，完全适应现代开发者的需求。在本文中，我们将探讨为什么 Prisma 会成为你最好的朋友（如果还不是的话 😉），以及如何将其与 Zod 结合使用，实现完美的数据验证。

为什么选择 Prisma？🤔

简而言之：Prisma 就是为了让你的工作更轻松。以下是 Prisma 的特别之处：

自动类型生成 🎉：自动生成 TypeScript 类型，让代码坚如磐石。
性能优化 🚀：Prisma 确保你的查询高效执行。告别疲惫的数据库！
简单易用 😎：清晰简洁的语法，让你享受编写查询的过程！

使用 pnpm 安装 Prisma 🛠️

准备好开始 Prisma 之旅了吗？让我们开始吧！首先执行以下命令：

bash

这将生成一个包含 schema.prisma 文件的 prisma 文件夹和用于数据库配置的 .env 文件。

为 PostgreSQL 配置 Prisma 🐘

在使用 Prisma 连接 PostgreSQL 之前，你需要一个可访问的 PostgreSQL 数据库。准备好数据库后，将连接 URL 添加到 Prisma 创建的 .env 文件中。例如：

dotenv

将 USER、PASSWORD、localhost、5432 和 my_database 替换为你的 PostgreSQL 连接信息。Prisma 将使用此 URL 连接到你的数据库。

然后，在 schema.prisma 文件中，确保数据库提供者（provider）配置为 PostgreSQL：

prisma

好了！Prisma 现已配置完成，可以连接 PostgreSQL 了。🎉

使用 Prisma 定义模型：博客示例 📝

假设你要创建一个博客（经典但实用）包含用户（User）和文章（Post）。以下是 schema.prisma 中的 Prisma 模型定义：

prisma

很简单，对吧？Prisma 让你可以声明如 User 和 Post 这样的模型，它们会自动处理关系和所有必要的细节。👌

数据库迁移：魔法继续 ✨

模型定义好后，是时候将其转换为数据库表了。这就是所谓的迁移。要执行你的第一次迁移，运行以下命令：

bash

瞧，你的数据库已经配置完成！Prisma 在后台完成了所有工作，就像一个真正的数据助手。🧙‍♀️

Prisma Client：执行查询的精灵 💡

Prisma Client 是一个强大的 ORM，让你可以轻松操作数据。以下是一些示例：

创建用户

typescript

读取数据

想要查看所有文章？这样做：

typescript

更新文章

有一篇草稿文章？没问题，一眨眼就能发布：

typescript

删除用户 😢

虽然有点伤感，但有时候是必要的。以下是如何删除用户及其所有相关文章：

typescript

高级部分：使用 Zod 进行数据验证 🛡️

Prisma 处理数据结构，但数据验证呢？这就是 Zod 登场的时候了！想象一个额外的安全层，确保数据在存入数据库之前就是正确的。这就是 Zod 的作用，而且它做得很优雅！🎩

集成 Zod：添加完美的验证 ⚔️

要在 Prisma 中使用 Zod，先安装它：

bash

定义 Zod 验证模式

让我们以用户创建为例，定义一个 Zod 模式来确保数据在传递给 Prisma 之前是正确的。

typescript

插入前的数据验证

在使用 Prisma 创建用户之前，我们用 Zod 验证数据。如果数据符合要求，就发送给 Prisma；如果不符合，就返回验证错误（这是不能绕过的！）。

typescript

关联数据的高级验证（更多乐趣 🤹‍♂️）

Zod 也适用于复杂数据。例如，创建 Post 时，我们要验证 authorId 存在且有效：

typescript

结论 🏁

使用 Prisma，数据库管理变得轻而易举（而且很有趣！）🎉。加入 Zod 后，你就拥有了一个强大的验证层，使你的代码更加健壮和安全。无论你在开发复杂的应用还是个人项目，这个组合都能为你提供可靠、快速、无忧的数据管理。那么，准备好把 Prisma 和 Zod 添加到你的工具箱了吗？🛠️

1# 如果还没有初始化 Node.js 项目，先初始化
2pnpm init -y
3
4# 安装 Prisma CLI
5pnpm add prisma --save-dev
6
7# 在项目中初始化 Prisma
8pnpm prisma init

1# 创建并应用迁移
2pnpm prisma migrate dev --name init

1pnpm add zod

1# .env
2DATABASE_URL="postgresql://USER:PASSWORD@localhost:5432/my_database?schema=public"

1// schema.prisma
2generator client {
3  provider = "prisma-client-js"
4}
5
6datasource db {
7  provider = "postgresql"
8  url      = env("DATABASE_URL")
9}

1// schema.prisma
2model User {
3  id      Int     @id @default(autoincrement())
4  name    String
5  email   String  @unique
6  posts   Post[]
7}
8
9model Post {
10  id        Int      @id @default(autoincrement())
11  title     String
12  content   String?
13  published Boolean  @default(false)
14  author    User     @relation(fields: [authorId], references: [id])
15  authorId  Int
16}

1import { PrismaClient } from '@prisma/client';
2const prisma = new PrismaClient();
3
4async function createUser() {
5  const user = await prisma.user.create({
6    data: {
7      name: 'Alice',
8      email: 'alice@example.com',
9    },
10  });
11  console.log(user);
12}
13
14createUser();

1async function getAllPosts() {
2  const posts = await prisma.post.findMany();
3  console.log(posts);
4}
5
6getAllPosts();

1async function publishPost(postId: number) {
2  const post = await prisma.post.update({
3    where: { id: postId },
4    data: { published: true },
5  });
6  console.log(post);
7}
8
9publishPost(1); // 发布 ID 为 1 的文章

1async function deleteUser(userId: number) {
2  await prisma.user.delete({
3    where: { id: userId },
4  });
5  console.log(`ID 为 ${userId} 的用户已被删除`);
6}
7
8deleteUser(1); // 删除 ID 为 1 的用户

1import { z } from 'zod';
2
3// User 验证模式
4const userSchema = z.object({
5  name: z.string().min(1, '名字是必需的'),
6  email: z.string().email('无效的邮箱地址'),
7});

1import { PrismaClient } from '@prisma/client';
2import { z } from 'zod';
3
4const prisma = new PrismaClient();
5
6async function createUser(data: unknown) {
7  // 使用 Zod 验证数据
8  const parsedData = userSchema.safeParse(data);
9  if (!parsedData.success) {
10    console.error(parsedData.error);
11    return;
12  }
13
14  // 验证成功后创建用户
15  const user = await prisma.user.create({
16    data: parsedData.data,
17  });
18  console.log(user);
19}
20
21// 函数调用示例
22createUser({ name: 'Bob', email: 'bob@example.com' });

1// Post 验证模式
2const postSchema = z.object({
3  title: z.string().min(1, '标题是必需的'),
4  content: z.string().optional(),
5  authorId: z.number().int().positive('authorId 必须是正整数'),
6});
7
8async function createPost(data: unknown) {
9  // 验证数据
10  const parsedData = postSchema.safeParse(data);
11  if (!parsedData.success) {
12    console.error(parsedData.error);
13    return;
14  }
15
16  // 验证成功后创建文章
17  const post = await prisma.post.create({
18    data: parsedData.data,
19  });
20  console.log(post);
21}
22
23// 函数调用示例
24createPost({ title: 'Prisma 入门', authorId: 1 });