※本記事には広告(楽天アフィリエイト)リンクが含まれる場合があります。

「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型説明
Stringtext / varchar文字列
Intinteger整数
Floatdouble precision浮動小数点
Booleanboolean真偽値
DateTimetimestamp日時
JsonjsonbJSONオブジェクト
Bytesbyteaバイナリ

よく使うアトリビュート

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

広告・楽天アフィリエイト

ノートパソコン特集

開発用ノートPCをスペック・口コミで比較。

楽天ポイント還元

ノートPCを楽天で見る →

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 が台頭しています。主な違いを整理します。

観点PrismaDrizzle
スキーマ定義独自言語(PSL)TypeScript コード
型安全◎(自動生成型)◎(推論型)
バンドルサイズ大きめ(クエリエンジン含む)軽量
エッジ対応△(Accelerate必要)◎(Cloudflare Workers等)
学習コスト低い(直感的)中程度(SQLに近い)
マイグレーションprisma migrate(強力)drizzle-kit(シンプル)
GUIPrisma 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 などのフレームワークと組み合わせて、型安全な全スタック開発を実現してみてください。