用途:本技能提供 Prisma Postgres 的创建、管理与集成指引,覆盖交互式与程序化两类工作流。
主要能力与用法:
- Console 工作流:打开 https://console.prisma.io,创建或选择工作区与项目,在项目侧边栏使用 Studio 查看/编辑数据,并从项目界面获取直连信息。
- 快速开通:运行 npx create-db@latest 立即获得数据库,别名有 npx create-pg@latest 与 npx create-postgres@latest;也可使用 create-db npm 包中的 create() / regions() 程序化 API。临时数据库约 24 小时后自动删除,除非认领。
- 关联已有本地项目:数据库已存在时用 prisma postgres link 将本地项目接入;CI 等非交互环境用 prisma postgres link --api-key "<your-api-key>" --database "db_..."。该流程会更新本地 .env 中的 DATABASE_URL,之后可运行 prisma generate 与 prisma migrate dev。
- Management API:接口位于 https://api.prisma.io/v1,可用 OpenAPI 文档 https://api.prisma.io/v1/doc 与 Swagger Editor https://api.prisma.io/v1/swagger-editor 查看;认证支持服务令牌(工作区服务间)与 OAuth 2.0(代表用户操作)。
- TypeScript SDK:安装 npm install @prisma/management-api-sdk,已有令牌用 createManagementApiClient,需要 OAuth 与令牌刷新用 createManagementApiSdk。
参考文档:create-db-cli.md(即时数据库与 CLI 参数 --ttl、--copy、--quiet、--open)、management-api.md(服务令牌与 OAuth 工作流)、management-api-sdk.md(带令牌存储的类型化 SDK)、console-and-connections.md(Console 操作、link、直连 TCP、无服务器驱动选择)。
限制:资料未提供价格、配额、区域可用性及具体错误处理细节,需以官方文档为准。