用途:为使用 Prisma 的项目配置 PostgreSQL 数据库连接,属于 Prisma 特性参考类技能。
前置条件:一个可用的 PostgreSQL 数据库(本地或云端)以及对应的连接字符串;资料未提供更详细的版本或环境要求。
必要用法:
- 在 prisma/schema.prisma 中设置数据源与生成器:datasource db { provider = "postgresql" },generator client { provider = "prisma-client" output = "../generated" }。
- 在 prisma.config.ts 中通过 defineConfig 指定 schema 路径,并用 env('DATABASE_URL') 读取数据源 URL。
- 在 .env 中设置 DATABASE_URL,格式为 postgresql://USER:PASSWORD@HOST:PORT/DATABASE?schema=SCHEMA;其中 USER、PASSWORD、HOST、PORT(默认 5432)、DATABASE、SCHEMA(默认 public)含义如资料所述,密码含特殊字符需 URL 编码。
- Prisma ORM 7 默认使用 query compiler,必须使用驱动适配器:执行 npm install @prisma/adapter-pg pg,并用 PrismaPg 传入 connectionString 实例化 PrismaClient。
常见问题排查:无法连接数据库时检查主机、端口、防火墙及数据库是否运行;认证失败时检查用户名密码及 URL 编码;schema 不存在时确认 URL 中包含 ?schema=public 或自定义 schema。
限制:资料仅覆盖上述配置与排查要点,未提供具体版本兼容范围、托管平台差异、迁移或部署步骤等信息。