Prisma データベース設定

様々なデータベースプロバイダーで Prisma ORM を設定するための包括的なガイド。

適用時期

以下の場合、このスキルを参照してください:

• 新しい Prisma プロジェクトを初期化するとき
• データベースプロバイダーを切り替えるとき
• 接続文字列と環境変数を設定するとき
• データベース接続の問題をトラブルシューティングするとき
• データベース固有の機能を設定するとき
• Prisma Client を生成およびインスタンス化するとき

ルールカテゴリ (優先度順)

優先度	カテゴリ	影響度	プレフィックス
1	プロバイダーガイド	CRITICAL	プロバイダー名
2	Prisma Postgres	HIGH	prisma-postgres
3	クライアント設定	CRITICAL	prisma-client-setup

システム要件

• Node.js 20.19.0+
• TypeScript 5.4.0+

Bun ランタイム

Bun を使用している場合、Prisma CLI コマンドを bunx --bun prisma ... で実行して、Prisma が Node.js にフォールバックせず Bun ランタイムを使用するようにしてください。

サポートされているデータベース

データベース	プロバイダー文字列	注記
PostgreSQL	postgresql	デフォルト、完全機能サポート
MySQL	mysql	広範なサポート、JSON に若干の差異
SQLite	sqlite	ローカルファイルベース、enum/スカラーリストなし
MongoDB	mongodb	MongoDB固有のワークフロー、SQL ドライバーアダプターのガイダンスは適用しないこと
SQL Server	sqlserver	Microsoft エコシステム
CockroachDB	cockroachdb	分散 SQL、Postgres 互換
Prisma Postgres	postgresql	マネージド サーバーレス データベース

設定ファイル

設定形式はプロバイダーと Prisma メジャーバージョンに応じて異なります:

1. すべてのプロバイダー は prisma/schema.prisma を使用します。
2. Prisma 7 SQL セットアップ は通常、データソース URL に prisma.config.ts を使用します。
3. MongoDB プロジェクトは Prisma 6.x に留まるべきで、スキーマで url = env("DATABASE_URL") を保持し、クラシック MongoDB セットアップを継続します。

ドライバーアダプター

標準的な SQL ワークフローはドライバーアダプターを使用します。データベースに対応したアダプターとドライバーを選択し、アダプターを PrismaClient に渡します。

データベース	アダプター	JS ドライバー
PostgreSQL	@prisma/adapter-pg	pg
CockroachDB	@prisma/adapter-pg	pg
Prisma Postgres (Node.js)	@prisma/adapter-pg	pg
Prisma Postgres (edge/serverless)	@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

MongoDB は Prisma 7 SQL アダプターワークフローに従うべきではありません。MongoDB プロジェクトには最新の Prisma 6.x リリースを使用し、SQL @prisma/adapter-* パッケージをインストールしないでください。

例 (PostgreSQL):

import 'dotenv/config'
import { PrismaClient } from '../generated/client'
import { PrismaPg } from '@prisma/adapter-pg'

const adapter = new PrismaPg({ connectionString: process.env.DATABASE_URL })
const prisma = new PrismaClient({ adapter })

Prisma クライアント設定 (必須)

Prisma Client は任意のデータベースでインストールおよび生成する必要があります。

1. Prisma CLI と Prisma Client をインストール:

   npm install prisma --save-dev
   npm install @prisma/client
   

2. ジェネレーターブロックを追加 (prisma-client は明示的な出力パスが必要):

   generator client {
     provider = "prisma-client"
     output   = "../generated"
   }
   

3. Prisma Client を生成:

   npx prisma generate
   

4. SQL プロバイダーの場合、データベース固有のドライバーアダプターで Prisma Client をインスタンス化:

   import { PrismaClient } from '../generated/client'
   import { PrismaPg } from '@prisma/adapter-pg'
   
   const adapter = new PrismaPg({ connectionString: process.env.DATABASE_URL })
   const prisma = new PrismaClient({ adapter })
   

5. スキーマの変更後、毎回 prisma generate を再実行します。

クイックリファレンス

PostgreSQL

datasource db {
  provider = "postgresql"
}

generator client {
  provider = "prisma-client"
  output   = "../generated"
}

MySQL

datasource db {
  provider = "mysql"
}

generator client {
  provider = "prisma-client"
  output   = "../generated"
}

SQLite

datasource db {
  provider = "sqlite"
}

generator client {
  provider = "prisma-client"
  output   = "../generated"
}

MongoDB

datasource db {
  provider = "mongodb"
  url      = env("DATABASE_URL")
}

generator client {
  provider = "prisma-client-js"
}

MongoDB の場合、最新の Prisma 6.x ラインに留まり、接続 URL を schema.prisma に保持します。MongoDB プロジェクトを Prisma 7 SQL アダプターセットアップに移行しないでください。

ルールファイル

詳細なセットアップ手順については、個別のルールファイルを参照してください:

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 の場合、SQL アダプターの例や Prisma 7 設定パターンをコピーする代わりに、references/mongodb.md を使用してください。