prisma管
轻松管理Prisma Postgres数据库
服务介绍
Prisma 是什么？
Prisma ORM 是一个下一代 ORM，它由以下工具组成：
- Prisma Client：自动生成且类型安全的查询构建器，适用于 Node.js 和 TypeScript
- Prisma Migrate：声明式数据建模和迁移系统
- Prisma Studio：用于查看和编辑数据库中数据的图形用户界面
Prisma Client 可以在任何 Node.js 或 TypeScript 后端应用程序（包括无服务器应用程序和微服务）中使用。这可以是一个 REST API，一个 GraphQL API，一个 gRPC API，或任何其他需要数据库的应用程序。
如果您需要一个与 Prisma ORM 一起使用的数据库，请参阅 Prisma Postgres。
入门指南
快速开始 (5分钟)
最快的方式是通过快速入门指南来开始使用 Prisma。您可以选择以下两个数据库之一：
使用您自己的数据库
如果您已经有自己的数据库，可以按照以下指南操作：
Prisma ORM 工作原理
本节提供了关于 Prisma ORM 如何工作及其最重要的技术组件的高级概述。如需更全面的介绍，请访问 Prisma 文档。
Prisma 模式
每个使用 Prisma 工具包中的工具的项目都始于一个 Prisma 模式文件。Prisma 模式允许开发人员以直观的数据建模语言定义他们的_应用程序模型_。它还包含与数据库的连接并定义了一个_生成器_：
// Data source
datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
}
// Generator
generator client {
provider = "prisma-client-js"
}
// Data model
model Post {
id Int @id @default(autoincrement())
title String
content String?
published Boolean @default(false)
author User? @relation(fields: [authorId], references: [id])
authorId Int?
}
model User {
id Int @id @default(autoincrement())
email String @unique
name String?
posts Post[]
}
在此模式中，您配置了三件事：
- 数据源：指定您的数据库连接（通过环境变量）
- 生成器：指示您希望生成 Prisma Client
- 数据模型：定义您的应用程序模型
Prisma 数据模型
本页的重点是数据模型。您可以在相应的文档页面上了解更多关于 数据源 和 生成器 的信息。
Prisma 模型的功能
数据模型是一组 模型 的集合。模型有两个主要功能：
- 代表底层数据库中的表
- 为 Prisma Client API 中的查询提供基础
获取数据模型
有两种主要的工作流程可以将数据模型“获取”到您的 Prisma 模式中：
- 通过对数据库进行 内省 来生成数据模型
- 手动编写数据模型，并使用 Prisma Migrate 将其映射到数据库
一旦定义了数据模型，您可以 生成 Prisma Client，这将为已定义的模型暴露 CRUD 及更多查询。如果您使用 TypeScript，所有查询（即使只检索模型字段的子集）都将获得完整的类型安全性。
使用 Prisma Client 访问数据库
生成 Prisma Client
使用 Prisma Client 的第一步是安装其 npm 包：
npm install @prisma/client
请注意，安装此包会调用 prisma generate 命令，该命令读取您的 Prisma 模式并_生成_ Prisma Client 代码。代码将位于 node_modules/.prisma/client 中，该目录由 node_modules/@prisma/client/index.d.ts 导出。
在更改数据模型后，您需要手动重新生成 Prisma Client 以确保 node_modules/.prisma/client 内的代码得到更新：
npx prisma generate
有关 "生成 Prisma 客户端" 的更多信息，请参阅文档。
使用 Prisma Client 向数据库发送查询
一旦生成了 Prisma Client，你可以在代码中导入它并向数据库发送查询。这是设置代码的样子。
导入并实例化 Prisma Client
你可以如下导入和实例化 Prisma Client：
import { PrismaClient } from '@prisma/client'
const prisma = new PrismaClient()
或者
const { PrismaClient } = require('@prisma/client')
const prisma = new PrismaClient()
现在你可以通过生成的 Prisma Client API 开始发送查询，这里有一些示例查询。请注意，所有 Prisma Client 查询都返回 普通的 JavaScript 对象。
更多关于可用操作的信息，请参阅 Prisma Client 文档 或观看此 演示视频（2分钟）。
从数据库检索所有 User 记录
const allUsers = await prisma.user.findMany()
在每个返回的 User 对象上包含 posts 关系
const allUsers = await prisma.user.findMany({
include: { posts: true },
})
筛选所有包含 "prisma" 的 Post 记录
const filteredPosts = await prisma.post.findMany({
where: {
OR: [{ title: { contains: 'prisma' } }, { content: { contains: 'prisma' } }],
},
})
在同一个查询中创建一个新的 User 和一个新的 Post 记录
const user = await prisma.user.create({
data: {
name: 'Alice',
email: 'alice@prisma.io',
posts: {
create: { title: 'Join us for Prisma Day 2021' },
},
},
})
更新现有的 Post 记录
const post = await prisma.post.update({
where: { id: 42 },
data: { published: true },
})
与 TypeScript 一起使用
请注意，当使用 TypeScript 时，此查询的结果将被 静态类型化，这样你就不会意外访问不存在的属性（并且任何拼写错误都会在编译时被捕获）。了解更多关于如何利用 Prisma Client 生成类型的高级用法，请参阅文档中的 生成类型的高级用法 页面。
社区
Prisma 拥有一个庞大且支持性的 社区，由热情的应用程序开发者组成。你可以在 Discord 和 GitHub 上加入我们。
徽章
用 Prisma 构建了很棒的东西？🌟 使用这些 徽章 展示你的成果，非常适合你的 readme 或网站。
[](https://prisma.io)
[](https://prisma.io)
MCP 服务器
Prisma CLI 包含一个 Prisma MCP 服务器。可以通过以下 CLI 命令启动它：
npx prisma mcp
大多数 AI 工具支持类似于这样的 JSON 配置用于 MCP 服务器：
{
"mcpServers": {
"Prisma": {
"command": "npx",
"args": ["-y", "prisma", "mcp"]
}
}
}
Prisma 的 MCP 服务器使 AI 代理能够管理 Prisma Postgres 数据库（例如，启动新的数据库实例或运行模式迁移）。
安全
如果你有安全问题需要报告，请通过 security@prisma.io 联系我们。
支持
关于 Prisma 的提问
你可以在 GitHub 上的 prisma 仓库中提出问题并发起 讨论 关于 Prisma 相关的话题。
👉 提问
为 Prisma 创建一个 bug 报告
如果你看到错误消息或遇到问题，请务必创建一个 bug 报告！你可以在文档中找到 创建 bug 报告的最佳实践（如包括额外的调试输出）。
提交功能请求
如果 Prisma 目前还没有某个功能，请务必查看路线图，看看这个功能是否已经在未来的计划中。
如果路线图上的功能链接到了一个 GitHub 问题，请确保在该问题下留下一个 👍 反应，并最好附上你对这个功能的看法！
👉 提交功能请求
贡献
测试状态
- Prisma 测试状态:
- 生态系统测试状态:
