SuperAPI AI 工具集

prisma-database-setup

编程与开发

查看项目

更新于 10-16 06:40

技能介绍

Prisma Database Setup 是一套面向 Prisma ORM 的数据库配置指南技能,用于帮助开发者在不同数据库提供商之间完成配置、连接与客户端初始化。

用途 该技能在以下场景中提供参考:初始化新的 Prisma 项目、切换数据库提供商、配置连接字符串和环境变量、排查数据库连接问题、设置数据库特定功能,以及生成和实例化 Prisma Client。

规则分类与优先级 规则按优先级分为三类:提供商指南(CRITICAL,前缀为 provider names)、Prisma Postgres(HIGH,前缀为 prisma-postgres)、客户端设置(CRITICAL,前缀为 prisma-client-setup)。

系统前提(Prisma ORM 7) 需要 Node.js 20.19.0+、TypeScript 5.4.0+ 以及 Bun 运行时。如果使用 Bun,需以 bunx --bun prisma ... 运行 Prisma CLI 命令,使 Prisma 使用 Bun 运行时而非回退到 Node.js。

支持的数据库 资料列出以下数据库及其提供商字符串:PostgreSQL(postgresql,默认,完整功能支持)、MySQL(mysql,广泛支持,存在部分 JSON 差异)、SQLite(sqlite,本地文件型,不支持 enum/标量列表)、MongoDB(mongodb,v7 不支持,需使用 v6)、SQL Server(sqlserver,微软生态)、CockroachDB(cockroachdb,分布式 SQL,兼容 Postgres)、Prisma Postgres(postgresql,托管无服务器数据库)。

配置文件 Prisma v7 使用两个主要配置文件:prisma/schema.prisma 定义 datasource 块;prisma.config.ts 配置连接 URL(替代 schema 中的 env 加载)。

驱动适配器(Prisma ORM 7) Prisma ORM 7 默认使用查询编译器,需要驱动适配器。需为数据库选择适配器和驱动,并将适配器传给 PrismaClient。对应关系为:PostgreSQL 与 CockroachDB 使用 @prisma/adapter-pg 与 pg;Prisma Postgres 使用 @prisma/adapter-ppg 与 @prisma/ppg;MySQL/MariaDB 使用 @prisma/adapter-mariadb 与 mariadb;SQLite 使用 @prisma/adapter-better-sqlite3 与 better-sqlite3;SQLite(Turso/LibSQL)使用 @prisma/adapter-libsql 与 @libsql/client;SQL Server 使用 @prisma/adapter-mssql 与 node-mssql。

Prisma Client 设置(必需) 任何数据库都必须安装并生成 Prisma Client。安装命令为 npm install prisma --save-dev 和 npm install @prisma/client。需添加 generator 块(Prisma v7 中 output 为必需):generator client { provider = "prisma-client" output = "../generated" }。生成命令为 npx prisma generate。实例化时需配合数据库特定的驱动适配器,例如 PostgreSQL 使用 PrismaPg 适配器并传入 connectionString。每次 schema 变更后需重新运行 prisma generate。

快速参考 资料提供了 PostgreSQL、MySQL、SQLite 的 datasource 与 generator 配置示例,以及 MongoDB(仅 Prisma v6)的配置示例(provider 为 mongodb,generator 为 prisma-client-js)。

规则文件 详细设置说明见各规则文件:references/postgresql.md、references/mysql.md、references/sqlite.md、references/mongodb.md、references/sqlserver.md、references/cockroachdb.md、references/prisma-postgres.md、references/prisma-client-setup.md。

使用方式 选择对应数据库的提供商参考文件,然后应用 references/prisma-client-setup.md 完成客户端生成与适配器设置。

限制 资料未提供收费、价格、平台或效果方面的信息;MongoDB 在 Prisma v7 中不受支持,需使用 v6。