用途:为不同数据库提供商配置 Prisma ORM,适用于初始化新 Prisma 项目、切换数据库提供商、配置连接字符串与环境变量、排查数据库连接问题、设置数据库特有功能,以及生成和实例化 Prisma Client。
主要能力:按优先级组织规则,包括提供商指南(CRITICAL)、Prisma Postgres(HIGH)、客户端设置(CRITICAL)。支持 PostgreSQL(默认,功能完整)、MySQL、SQLite、MongoDB(v7 不支持,需用 v6)、SQL Server、CockroachDB 和 Prisma Postgres。
系统前提(Prisma ORM 7):Node.js 20.19.0+、TypeScript 5.4.0+、Bun 运行时。使用 Bun 时以 bunx --bun prisma ... 运行 CLI,使 Prisma 使用 Bun 而非回退到 Node.js。
配置方式:Prisma v7 使用 prisma/schema.prisma 定义 datasource 块,prisma.config.ts 配置连接 URL(取代 schema 中的 env 加载)。v7 默认使用查询编译器,需要驱动适配器,例如 PostgreSQL 用 @prisma/adapter-pg 与 pg,MySQL/MariaDB 用 @prisma/adapter-mariadb 与 mariadb,SQLite 用 @prisma/adapter-better-sqlite3 与 better-sqlite3,SQL Server 用 @prisma/adapter-mssql 与 node-mssql。
客户端设置:安装 npm install prisma --save-dev 与 npm install @prisma/client;添加 generator 块(v7 中 output 必填);运行 npx prisma generate;用对应适配器实例化 PrismaClient。每次修改 schema 后需重新运行 prisma generate。
限制:MongoDB 在 v7 中不受支持,需使用 v6;SQLite 不支持枚举和标量列表;MySQL 存在部分 JSON 差异。详细步骤见各提供商参考文件及 prisma-client-setup.md。