※本記事には広告(楽天アフィリエイト)リンクが含まれる場合があります。
「SQLを書くと型が消える」「ORMのクエリが複雑で読みづらい」「マイグレーション管理が煩雑」——Node.js/TypeScriptでデータベースを扱う際のこうした悩みを解決するのが Prisma ORM です。
Prisma は スキーマファーストのORM として、2026年現在も Node.js/TypeScript プロジェクトで最も広く採用されているデータベースアクセスライブラリです。直感的なスキーマ定義言語・完全な型安全・強力なマイグレーション機能を兼ね備えており、個人開発からエンタープライズまで幅広く利用されています。
この記事では、Prisma v6 のインストールから Schema定義・マイグレーション・CRUD・リレーション・Prisma Studio・Neon/Supabaseとの連携・Drizzle ORMとの比較まで徹底解説します。
Prisma ORMとは?なぜ選ばれるのか
Prisma は 3つのコアコンポーネント から成る次世代 ORM です。
- Prisma Client — 自動生成される型安全なクエリビルダー
- Prisma Migrate — スキーマ変更をSQLマイグレーションに変換するツール
- Prisma Studio — データを GUI で閲覧・編集できるブラウザUI
TypeScript との相性が抜群で、スキーマを schema.prisma ファイルに書くだけで、全クエリに完全な型推論が得られます。
対応データベース
- PostgreSQL(Neon・Supabase・RDS など)
- MySQL / MariaDB
- SQLite
- SQL Server
- MongoDB(プレビュー)
- CockroachDB
インストールとセットアップ
1. パッケージのインストール
npm install @prisma/client
npm install -D prisma
2. 初期化
npx prisma init
このコマンドで prisma/schema.prisma と .env が作成されます。
3. DATABASE_URL の設定
# .env
DATABASE_URL="postgresql://user:password@localhost:5432/mydb?schema=public"
Neon を使う場合は接続プーリング付きのURLを使います。
DATABASE_URL="postgresql://user:password@ep-xxx.us-east-2.aws.neon.tech/neondb?sslmode=require"
スキーマ定義
Prisma はデータモデルを Prisma Schema Language(PSL) で定義します。SQLに慣れていなくても直感的に書けるのが特徴です。
// prisma/schema.prisma
generator client {
provider = "prisma-client-js"
}
datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
}
model User {
id Int @id @default(autoincrement())
email String @unique
name String?
createdAt DateTime @default(now())
updatedAt DateTime @updatedAt
posts Post[]
}
model Post {
id Int @id @default(autoincrement())
title String
content String?
published Boolean @default(false)
authorId Int
author User @relation(fields: [authorId], references: [id])
createdAt DateTime @default(now())
}
フィールド型一覧
| Prisma型 | PostgreSQL型 | 説明 |
|---|---|---|
| String | text / varchar | 文字列 |
| Int | integer | 整数 |
| Float | double precision | 浮動小数点 |
| Boolean | boolean | 真偽値 |
| DateTime | timestamp | 日時 |
| Json | jsonb | JSONオブジェクト |
| Bytes | bytea | バイナリ |
よく使うアトリビュート
model Example {
id String @id @default(cuid()) // cuid2 ID
uuid String @default(uuid()) // UUID
createdAt DateTime @default(now()) // 作成日時
updatedAt DateTime @updatedAt // 更新日時(自動)
email String @unique // ユニーク制約
slug String @unique
@@index([email]) // インデックス
@@unique([firstName, lastName]) // 複合ユニーク
}
マイグレーション
スキーマを変更したら、以下のコマンドでマイグレーションを作成・適用します。
開発環境
# マイグレーションファイルを作成して即適用
npx prisma migrate dev --name add_user_table
# マイグレーション履歴を確認
npx prisma migrate status
本番環境
# 本番DBにマイグレーションを適用(新規ファイルは作成しない)
npx prisma migrate deploy
データベースのリセット(開発時のみ)
# DBを削除して再作成・マイグレーション適用
npx prisma migrate reset
Prisma Clientの再生成
スキーマを変更したら Client を再生成して型を更新します。
npx prisma generate
CRUD操作の基本
Prisma Client を使ったデータ操作の基本パターンを紹介します。
クライアントの初期化
import { PrismaClient } from '@prisma/client'
const prisma = new PrismaClient()
// Next.js / サーバーレス環境でのシングルトン
declare global {
var prismaInstance: PrismaClient | undefined
}
export const db = globalThis.prismaInstance ?? new PrismaClient()
if (process.env.NODE_ENV !== 'production') globalThis.prismaInstance = db
Create(作成)
// 1件作成
const user = await prisma.user.create({
data: {
email: 'alice@example.com',
name: 'Alice',
},
})
// 関連レコードと同時作成(ネストした create)
const post = await prisma.post.create({
data: {
title: 'はじめての Prisma',
author: {
create: {
email: 'bob@example.com',
name: 'Bob',
},
},
},
})
// 複数件一括作成
await prisma.user.createMany({
data: [
{ email: 'carol@example.com', name: 'Carol' },
{ email: 'dave@example.com', name: 'Dave' },
],
})
Read(取得)
// ID で1件取得(null の可能性あり)
const user = await prisma.user.findUnique({
where: { id: 1 },
})
// 見つからなければエラー
const user = await prisma.user.findUniqueOrThrow({
where: { email: 'alice@example.com' },
})
// 条件で複数取得
const posts = await prisma.post.findMany({
where: {
published: true,
author: { name: { contains: 'Alice' } },
},
orderBy: { createdAt: 'desc' },
take: 10,
skip: 0,
})
// リレーションを含めて取得
const userWithPosts = await prisma.user.findUnique({
where: { id: 1 },
include: {
posts: {
where: { published: true },
orderBy: { createdAt: 'desc' },
},
},
})
Update(更新)
// 1件更新
const updated = await prisma.user.update({
where: { id: 1 },
data: { name: 'Alice Updated' },
})
// upsert(存在すれば更新、なければ作成)
const user = await prisma.user.upsert({
where: { email: 'alice@example.com' },
update: { name: 'Alice Updated' },
create: { email: 'alice@example.com', name: 'Alice' },
})
// 複数件更新
await prisma.post.updateMany({
where: { authorId: 1 },
data: { published: true },
})
Delete(削除)
// 1件削除
await prisma.user.delete({
where: { id: 1 },
})
// 条件に一致する複数件削除
await prisma.post.deleteMany({
where: {
createdAt: { lt: new Date('2025-01-01') },
},
})
リレーションの扱い
Prismaのリレーション定義は3種類あります。
1対多(One-to-Many)
model User {
id Int @id @default(autoincrement())
posts Post[]
}
model Post {
id Int @id @default(autoincrement())
authorId Int
author User @relation(fields: [authorId], references: [id])
}
多対多(Many-to-Many)
// 暗黙的な多対多(中間テーブル自動生成)
model Post {
id Int @id @default(autoincrement())
tags Tag[]
}
model Tag {
id Int @id @default(autoincrement())
name String @unique
posts Post[]
}
// 明示的な多対多(中間テーブルにフィールドを追加したい場合)
model Post {
id Int @id @default(autoincrement())
tagLinks PostToTag[]
}
model Tag {
id Int @id @default(autoincrement())
name String @unique
postLinks PostToTag[]
}
model PostToTag {
postId Int
tagId Int
assignedAt DateTime @default(now())
post Post @relation(fields: [postId], references: [id])
tag Tag @relation(fields: [tagId], references: [id])
@@id([postId, tagId])
}
1対1(One-to-One)
model User {
id Int @id @default(autoincrement())
profile Profile?
}
model Profile {
id Int @id @default(autoincrement())
bio String
userId Int @unique
user User @relation(fields: [userId], references: [id])
}
フィルタリングと集計
Prisma のクエリ条件はネストできる点が強力です。
// 複雑な条件
const posts = await prisma.post.findMany({
where: {
OR: [
{ title: { contains: 'Prisma' } },
{ content: { contains: 'ORM' } },
],
AND: [
{ published: true },
{ createdAt: { gte: new Date('2026-01-01') } },
],
NOT: { authorId: 99 },
},
})
// 集計
const stats = await prisma.post.aggregate({
_count: { id: true },
_avg: { viewCount: true },
_max: { createdAt: true },
where: { published: true },
})
// グルーピング
const grouped = await prisma.post.groupBy({
by: ['authorId'],
_count: { id: true },
orderBy: { _count: { id: 'desc' } },
})
トランザクション
複数の操作をアトミックに実行したい場合はトランザクションを使います。
// $transaction APIを使う
const [user, post] = await prisma.$transaction([
prisma.user.create({ data: { email: 'tx@example.com', name: 'TX User' } }),
prisma.post.create({ data: { title: 'TX Post', authorId: 1 } }),
])
// インタラクティブトランザクション(前の操作の結果を使う場合)
const result = await prisma.$transaction(async (tx) => {
const user = await tx.user.create({
data: { email: 'new@example.com', name: 'New' },
})
const post = await tx.post.create({
data: { title: 'My Post', authorId: user.id },
})
return { user, post }
})
Prisma Studio
Prisma には GUI でデータを閲覧・編集できる Prisma Studio が付属しています。
npx prisma studio
ブラウザで http://localhost:5555 が開き、全テーブルのデータをスプレッドシート形式で確認・編集できます。開発時のデータ確認に非常に便利です。
Neon Postgresとの連携
Neon はサーバーレス PostgreSQL で、Prisma との相性が非常によいです。接続プーリングの設定がポイントになります。
# .env
# 直接接続(マイグレーション用)
DATABASE_URL="postgresql://user:password@ep-xxx.us-east-2.aws.neon.tech/neondb?sslmode=require"
# プーリング接続(アプリケーション用)
DATABASE_URL_UNPOOLED="postgresql://user:password@ep-xxx.us-east-2.aws.neon.tech/neondb?sslmode=require"
// schema.prisma
datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
directUrl = env("DATABASE_URL_UNPOOLED")
}
Neon との具体的な構築手順は Neon Postgres完全ガイド も参照してください。
Supabaseとの連携
Supabase でも Prisma を利用できます。Supabase の Transaction モード(ポート6543) を Prisma Client に使い、Session モード(ポート5432) をマイグレーションに使うのが推奨構成です。
# .env
DATABASE_URL="postgresql://postgres:[PASSWORD]@db.xxx.supabase.co:6543/postgres?pgbouncer=true"
DIRECT_URL="postgresql://postgres:[PASSWORD]@db.xxx.supabase.co:5432/postgres"
// schema.prisma
datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
directUrl = env("DIRECT_URL")
}
Prisma vs Drizzle ORM:どちらを選ぶか
2026年現在、Prisma に対して Drizzle ORM が台頭しています。主な違いを整理します。
| 観点 | Prisma | Drizzle |
|---|---|---|
| スキーマ定義 | 独自言語(PSL) | TypeScript コード |
| 型安全 | ◎(自動生成型) | ◎(推論型) |
| バンドルサイズ | 大きめ(クエリエンジン含む) | 軽量 |
| エッジ対応 | △(Accelerate必要) | ◎(Cloudflare Workers等) |
| 学習コスト | 低い(直感的) | 中程度(SQLに近い) |
| マイグレーション | prisma migrate(強力) | drizzle-kit(シンプル) |
| GUI | Prisma Studio(◎) | Drizzle Studio(◯) |
| コミュニティ | 大規模・枯熟 | 急成長中 |
Prismaが向いているケース
- チーム開発でスキーマを分かりやすく共有したい
- Prisma Studio でノンエンジニアもデータ確認したい
- マイグレーション管理を堅牢にしたい
- Next.js + Vercel のスタンダード構成
Drizzleが向いているケース
- Cloudflare Workers などエッジ環境で動かしたい
- バンドルサイズを最小化したい
- SQLに近い書き方でクエリをコントロールしたい
パフォーマンスのTips
N+1問題を避ける
// NG: N+1になる
const users = await prisma.user.findMany()
for (const user of users) {
const posts = await prisma.post.findMany({ where: { authorId: user.id } })
}
// OK: include でまとめて取得
const users = await prisma.user.findMany({
include: { posts: true },
})
必要なフィールドのみ取得(select)
// 全フィールドではなく必要なものだけ選択
const users = await prisma.user.findMany({
select: {
id: true,
email: true,
name: true,
// posts は取得しない
},
})
インデックスを適切に設定する
model Post {
id Int @id @default(autoincrement())
authorId Int
slug String @unique
@@index([authorId]) // 頻繁に絞り込むカラム
@@index([authorId, createdAt]) // 複合インデックス
}
接続プール設定
const prisma = new PrismaClient({
datasources: {
db: {
url: process.env.DATABASE_URL,
},
},
log: process.env.NODE_ENV === 'development' ? ['query', 'error'] : ['error'],
})
まとめ
Prisma ORM は 型安全・スキーマファースト・強力なマイグレーション を兼ね備えた Node.js 開発の定番ライブラリです。
- スキーマ定義は PSL で直感的に書け、型は自動生成される
- マイグレーションは
prisma migrate dev/deployで簡単管理 - CRUD操作は
create・findMany・update・deleteのシンプルな API - Prisma Studio でデータを GUI 確認できる
- Neon・Supabase との連携は
directUrl設定で対応 - エッジ環境やバンドルサイズを重視するなら Drizzle も検討
Next.js・Astro・Hono などのフレームワークと組み合わせて、型安全な全スタック開発を実現してみてください。