第7章 Prisma Postgres 托管数据库入门

Prisma Postgres 从 Prisma ORM、Serverless 运行时和 PostgreSQL 客户端连接 Prisma Postgres。Prisma Postgres 是一款托管的 PostgreSQL 数据库，内置连接池和边缘运行时支持。

对于你的应用程序来说，它就是一个位于连接字符串背后的普通 PostgreSQL 数据库：

你的应用程序 ↓ DATABASE_URL Prisma Postgres

任何 PostgreSQL 客户端都适用：Prisma ORM、psql、Kysely、Drizzle、node-postgres 或任何其他支持 Postgres 协议的客户端。

快速上手 1. 创建数据库 最快且无需注册账号的方式： bunx create-db@latest create-db 会创建一个临时的 Prisma Postgres 数据库，并打印出连接字符串和认领 URL。打开认领 URL 即可将数据库保留在你的工作空间中。详情参见 create-db 文档。你也可以在控制台或通过 Prisma CLI（npx prisma postgres create）创建数据库。如果你的数据已经存在于笔记本电脑或其他主机上的 PostgreSQL 数据库中，可以分三步将其迁移到 Prisma Postgres：创建数据库、pg_dump、pg_restore。

2. 复制连接字符串 create-db 只会打印一次连接字符串。对于现有数据库，请在 Prisma Console 中打开它，点击“连接到你的数据库”。将其存储在你的应用程序读取配置的位置： .envDATABASE_URL="postgres://...@db.prisma.io:5432/postgres?sslmode=require"

3. 连接并运行查询 选择你使用的客户端；每个快速入门指南都会带你从连接字符串到第一个查询： Prisma ORM 快速入门：定义数据契约并使用 Prisma ORM 进行查询。 Prisma ORM 7 快速入门：使用当前正式发布的 Prisma ORM 进行连接。 Kysely 快速入门：从 Kysely 连接 Prisma Postgres。 Drizzle ORM 快速入门：从 Drizzle ORM 连接 Prisma Postgres。

另外还提供：TypeORM 快速入门 以及 连接到你的数据库 指南，后者涵盖了 psql、GUI 工具和 Serverless 运行时的连接字符串配置。

如果你使用编码代理，请复制此提示词： 使用你的代理使用你的代理为此项目创建一个 Prisma Postgres 数据库。

1. 运行 `npx create-db@latest`。它会创建一个临时的 Prisma Postgres 数据库，无需账号，并打印出连接字符串和认领 URL。 2. 将连接字符串作为 DATABASE_URL 放入 `.env` 文件，并将其接入项目已使用的客户端（如 Prisma ORM、Kysely、Drizzle、TypeORM 或 node-postgres）（从 package.json 检测；如果没有，请询问我）。通过一个简单的查询（例如 `select 1`）验证连接。 3. 提醒我打开认领 URL，以将数据库保留在我的 Prisma 工作空间中。

当前文档：https://www.prisma.io/docs/postgres.md。 包含内容 每个 Prisma Postgres 数据库都包含以下功能，无需额外配置服务：

连接池：一个专用的 PgBouncer 实例随数据库一起运行，无需设置或管理。它也适用于 Serverless 和边缘部署。参见 连接池。 边缘和 Serverless 支持：通过 Serverless 驱动程序从 Cloudflare Workers、Vercel Edge Functions 和其他边缘运行时连接，该驱动程序使用 HTTP 而非 TCP。 自动备份（Starter、Pro 和 Business 套餐）：每日快照，根据套餐保留 7 天或 30 天。参见 备份。

本地开发 使用 prisma dev 在本地运行 Prisma Postgres，准备好后再切换到云端。

本地 Postgres

与其他 Prisma 组件配合使用 每个集成都是可选的。Prisma Postgres 可与任何 PostgreSQL 客户端配合使用。

如果你使用 Prisma ORM，快速入门指南会创建一个数据库并将其连接到你的数据契约。 如果你部署在 Prisma Compute 上，Compute 项目的每个分支都可以拥有自己的 Prisma Postgres 数据库；通过环境变量传递连接字符串。 对于多服务应用程序，Prisma Composer 将数据库声明为服务依赖项，并在运行时注入连接。

管理

连接到你的数据库 连接池 备份 PostgreSQL 扩展 故障排除 常见问题

计费与限制 Prisma Postgres 采用基于使用量的定价模式，并包含支出控制。

定价 基于操作量的计费说明 常见问题：成本估算

在 Prisma Console 中，你可以跟踪使用量、设置支出限制并查看账单详情。

技术细节 Prisma Postgres 基于 PostgreSQL v17 并采用基于 Unikernel 的架构。 了解更多：Prisma Postgres：构建现代 PostgreSQL 服务。 注意 Postgres、PostgreSQL 和 Slonik Logo 是 PostgreSQL Community Association of Canada 的商标或注册商标，并获准使用。在 GitHub 上编辑 create-db 学习如何使用 create-db 配置临时的 Prisma Postgres 数据库