npx create-db

create-db 是一个开源 CLI 工具，只需一个命令即可配置临时 Prisma Postgres 数据库。

• 快速设置：无需注册即可创建临时可用于生产的 Prisma Postgres 数据库。
• 生命周期：每个数据库默认可用24 小时。
• 免费保留：您可以通过 CLI 输出中提供的 URL 认领数据库，使其永久化。

先决条件

要使用 npx create-db，您需要

• Node.js 版本 16 或更高版本（我们推荐最新的 LTS 版本）。
• npm（随 Node.js 一起提供）来运行 npx 命令。

无需 Prisma Data Platform 账户即可创建临时数据库。但是，如果您想永久保留数据库，可以认领它（详情如下）。

选项 1：使用网页界面（推荐）

create-db 网页应用程序提供了一个基于浏览器的界面，用于创建和管理数据库。

主要功能：

• 无需安装 - 直接在网络浏览器中运行
• 用于数据库管理的直观界面
• 轻松显示和复制连接字符串
• 内置模式查看器和编辑器
• 与 Prisma Studio 直接集成
• 简单的数据库认领工作流

入门：

1. 在网络浏览器中访问 create-db.prisma.io
2. 点击“使用网页界面创建”
3. 修改您的模式并与 Studio 交互
4. 复制为您的项目提供的连接字符串
5. 认领您的数据库以使其永久化

选项 2：使用 CLI

您可以使用以下选项之一创建数据库

选项 1：使用默认设置快速启动

在终端中运行以下命令

npx create-db@latest

• @latest 标签会自动下载并运行最新版本的工具，因此无需全局安装。
• 几秒钟后，您将收到适用于 Prisma ORM 项目和标准 PostgreSQL 的连接字符串。
• 默认区域是 us-east-1。您可以使用 --region 标志指定要配置数据库的区域。请参阅以下部分以查看所有 CLI 选项。

选项 2：交互式选择区域

如果您想手动选择区域

npx create-db@latest --interactive

• 这将打开一个区域选择菜单（例如，us-east-1，eu-west-3）。
• 或者，您可以使用简写 -i

npx create-db@latest -i

查看所有选项和区域

npx create-db@latest --help

CLI 输出演练

这是一个输出示例

┌  🚀 Creating a Prisma Postgres database
│
│  Provisioning a temporary database in us-east-1...
│  It will be automatically deleted in 24 hours, but you can claim it.
◇  Database created successfully!
│
●  Database Connection
│    Connection String:
│    postgresql://<username>:<password>@db.prisma.io:5432/postgres
│
◆  Claim your database →
│    Keep your database for free:
│    https://create-db.prisma.io?projectID=proj_...
└

获得输出后，复制连接字符串并将其添加到您的 .env 文件中作为 DATABASE_URL

DATABASE_URL="postgresql://<username>:<password>@db.prisma.io:5432/postgres"

您现在可以按照 Prisma Postgres 快速入门指南将您的 Prisma 项目连接到此数据库。

如果您正在使用其他工具或库，请使用标准 PostgreSQL 连接字符串（postgresql://...）与任何 PostgreSQL 兼容的客户端，例如 psql、pgAdmin、node-postgres 或您选择的 ORM。有关详细说明，请参阅 通过直接 PostgreSQL 连接字符串连接的指南。

认领您的数据库

默认情况下，使用 npx create-db 创建的数据库是临时的，并将在 24 小时后自动删除。

您可以通过使用 CLI 输出中显示的认领 URL 认领数据库来防止这种情况发生

◆  Claim your database →
│
│    Want to keep your database? Claim for free:
│
│    https://create-db.prisma.io?projectID=proj_...
│
│    Your database will be deleted on 7/24/2025, 2:25:41 AM if not claimed.

要认领您的数据库并使其永久化

1. 从 CLI 输出中复制认领 URL。
2. 在浏览器中打开它并点击认领数据库。
3. 登录您的（如果您还没有，请创建一个）。
4. 选择一个有能力创建新项目的工作区。
5. 点击授权 Prisma Create DB 以确认。
6. 您将被重定向到成功页面。然后，点击去使用您的数据库以在您的工作区中查看和管理已认领的数据库。

当您认领数据库时

• 它会移动到您的 Prisma Data Platform 账户工作区中。
• 它不再在 24 小时后自动删除。
• 您可以继续将其用作永久数据库实例。

可用 CLI 选项

以下是 npx create-db 命令的 CLI 标志

标志	简写	描述
--region	-r	指定区域。 可用区域：ap-southeast-1、ap-northeast-1、eu-central-1、eu-west-3、us-east-1、us-west-1
--interactive	-i	以交互模式运行（从列表中选择区域）。
--json	-j	输出机器可读的 JSON 并退出。
--help	-h	显示此帮助消息。

要查看所有 CLI 选项，请使用 --help 或 -h 标志

npx create-db@latest --help

显示CLI结果