prisma-postgres

Prisma Postgres

在交互式和编程式工作流中创建、管理和集成 Prisma Postgres 的指南。

何时使用

在以下情况下参考此技能：

• 从 Prisma 控制台设置 Prisma Postgres
• 使用 create-db 配置即时临时数据库
• 使用 prisma postgres link 链接现有本地项目
• 通过管理 API 管理 Prisma Postgres 资源
• 在 TypeScript/JavaScript 中使用 @prisma/management-api-sdk
• 处理声明 URL、连接字符串、区域和认证流程

按优先级分类的规则类别

优先级	类别	影响	前缀
1	CLI 配置	关键	create-db-cli
2	管理 API	关键	management-api
3	管理 API SDK	高	management-api-sdk
4	控制台与连接	高	console-and-connections

快速参考

• create-db-cli - 即时数据库和当前 CLI 标志（--ttl、--copy、--quiet、--open）
• management-api - 服务令牌和 OAuth API 工作流
• management-api-sdk - 带令牌存储的类型化 SDK 使用
• console-and-connections - 控制台操作、prisma postgres link、直接 TCP 连接和 serverless-driver 选择

核心工作流

1. 控制台优先工作流

使用 Prisma 控制台进行手动设置和操作：

• 打开 https://console.prisma.io
• 创建/选择工作区和项目
• 使用项目侧边栏中的 Studio 查看/编辑数据
• 从项目 UI 获取直接连接详情

2. 使用 create-db 快速配置

当需要立即使用数据库时，使用 create-db：

npx create-db@latest

别名：

npx create-pg@latest
npx create-postgres@latest

对于应用集成，您也可以使用 create-db npm 包中的编程 API（create() / regions()）。

临时数据库大约在 24 小时后自动删除，除非声明。

3. 链接现有本地项目

当数据库已存在且您希望将本地项目连接到它时，使用 prisma postgres link：

prisma postgres link

对于 CI 或其他非交互式环境：

prisma postgres link --api-key "<your-api-key>" --database "db_..."

此流程会更新您的本地 .env 文件中的 DATABASE_URL，然后您可以运行 prisma generate 和 prisma migrate dev。

4. 使用管理 API 进行编程式配置

在以下地址使用 API 端点：

https://api.prisma.io/v1

使用以下工具探索模式和端点：

• OpenAPI 文档：https://api.prisma.io/v1/doc
• Swagger 编辑器：https://api.prisma.io/v1/swagger-editor

认证选项：

• 服务令牌（工作区服务器到服务器）
• OAuth 2.0（代表用户操作）

5. 使用管理 API SDK 进行类型安全集成

安装并使用：

npm install @prisma/management-api-sdk

对于现有令牌，使用 createManagementApiClient；对于 OAuth + 令牌刷新，使用 createManagementApiSdk。

规则文件

详细指南位于：

references/console-and-connections.md
references/create-db-cli.md
references/management-api.md
references/management-api-sdk.md

如何使用

从 references/create-db-cli.md 开始快速设置，然后在需要编程式配置时切换到 references/management-api.md 或 references/management-api-sdk.md。