注目キーワード

Prisma完全網羅ガイド｜Next.jsへの導入から主要コマンドの使い方まで徹底解説

  • 2026.06.05
       
Prisma完全網羅ガイド｜Next.jsへの導入から主要コマンドの使い方まで徹底解説

Webアプリケーション開発では、ユーザー情報や投稿データなどをデータベースへ保存・取得する処理が欠かせません。
しかしながら、SQL文を記述してデータベースを操作する方法は、柔軟性が高い反面コード量が増えやすく、型安全性の確保も課題となります。

そこで、近年のTypeScript・Next.js開発で広く採用されているのが、SQL文を記述することなくデータベースを操作することのできる「ORM（Object Relational Mapping）」 と呼ばれるツールです。

本記事では、その中でも特に人気が高い Prisma について紹介していきたいと思います。

  • Prismaの基本
  • Next.js環境での導入方法
  • 具体的な使用方法 (CRUD処理、マイグレーション管理)
  • 近年人気のDrizzle ORMとの比較

など、詳しく解説していきますので、ぜひ参考にしてみてください。

目次

Prismaとは

Prismaは、Node.js および TypeScript 向けのORMです。
型安全なデータベース操作を実現しながら、スキーマ管理やマイグレーション機能も提供するモダンなORMとして、多くのNext.jsプロジェクトで採用されています。

従来のORMでは、型安全性の不足や設定の複雑さなどが問題となるケースもありましたが、Prismaは「型安全性」と「開発体験（DX）」を重視して設計されているため、これらの問題を解消してくれるツールとなっています。

Prismaの主な特徴は、以下のとおりです。

  • TypeScriptによる強力な型補完
  • PostgreSQL、MySQL、SQLiteなどに対応
  • Prisma Clientによる直感的なデータ操作
  • スキーマベースのデータベース管理
  • マイグレーション機能を標準搭載

Prisma ormの初期設定：Next.js環境での導入とスキーマ定義

パッケージのインストールとschema.prismaの基本構造

Prismaのインストールは、以下のコマンドで実行可能です。
「prisma」 は CLI、「@prisma/client 」 はクライアントをインストールできます。

Node.jsのインストールがまだの場合は、そちらを先に済ませてから実行してください。

npm install prisma @prisma/client

インストールが完了したら、続いて初期化コマンドを実行します。

npx prisma init

コマンドを実行すると、以下のような構成でディレクトリとファイルが生成されます。

sample-app/
├── prisma/
│ └── schema.prisma
└── .env

schema.prismaは、Prismaの中心となる設定ファイルです。
例えば、以下のような内容が記述されています。

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

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

model User {
  id    Int    @id @default(autoincrement())
  name  String
  email String @unique
}

各ブロックの役割は次の通りです。

  • generator … Prisma Client生成設定
  • datasource … 接続先データベースの設定
  • model … データベースのテーブル定義

PostgreSQLやMySQLとシームレスに接続するための環境変数設定

データベースの接続情報は .envファイルに記述するのが基本です。
例えば、以下のように環境変数を設定します。

PostgreSQLの場合:

DATABASE_URL="postgresql://user:password@localhost:5432/sampledb"

MySQLの場合:

DATABASE_URL="mysql://user:password@localhost:3306/sampledb"

接続情報をコードへ直接書かず、環境変数として.envファイルで管理することにより、開発環境と本番環境を安全に切り替えることができます。

【実践】Next.jsでデータベースを操作するCRUDの具体例

PrismaClientの初期設定とシングルトンパターンによる多重接続防止

PrismaClientはホットリロードの度に新しいインスタンスを生成するため、無駄な接続を増やさないためにシングルトン化することが推奨されています。

import { PrismaClient } from "@prisma/client";

const globalForPrisma = globalThis as unknown as {
  prisma: PrismaClient | undefined;
};

export const prisma =
  globalForPrisma.prisma ??
  new PrismaClient();

if (process.env.NODE_ENV !== "production") {
  globalForPrisma.prisma = prisma;
}

これにより、不要な接続増加を防ぐことができます。

Server ActionsやRoute Handlersでのデータ取得・保存コード例

データ操作に関するコードをいくつか紹介します。

データ取得（Read）:

const users = await prisma.user.findMany();

データ登録（Create）:

await prisma.user.create({
  data: {
    name: "Taro",
    email: "taro@example.com",
  },
});

データ更新（Update）:

await prisma.user.update({
  where: {
    id: 1,
  },
  data: {
    name: "Jiro",
  },
});

データ削除（Delete）:

await prisma.user.delete({
  where: {
    id: 1,
  },
});

以下は、Route Handlerで利用する例です。

import { prisma } from "@/lib/prisma";

export async function GET() {
  const users = await prisma.user.findMany();

  return Response.json(users);
}

このように、少ないコード量でCRUDを実装できます。

Prisma dbコマンドの活用：db pushとdb pullによる効率的な開発

プロトタイプ開発を加速させるprisma db pushの使い方

スキーマ変更を即座にデータベースに反映したい場合は、db pushを使用します。

npx prisma db push

コマンドを実行すると、schema.prismaの内容がそのままデータベースへ適用されます。

特徴:
・即座にデータベースに反映
・マイグレーションファイルを生成しない
・個人開発や検証環境向け (破壊的変更の可能性があるため)

例えば以下のように、Userモデルへカラムを追加した後、db pushを実行するだけで反映されます。

model User {
  id Int @id @default(autoincrement())
  name String
  age Int?
}

既存のデータベース構造をスキーマへ逆生成するprisma db pullの役割

既存のデータベースからスキーマを生成する場合は、db pullを利用します。

npx prisma db pull

コマンドを実行すると、データベースの構造を解析してschema.prismaに反映させます。
既存システムへPrismaを導入する際に便利です。

【運用】prisma migrateを用いた安全なマイグレーション管理

チーム開発で変更履歴をSQLとして残すmigrate devの仕組み

本格的な開発では、マイグレーション管理が重要となります。
開発時のマイグレーションは以下のコマンドで実行します。

npx prisma migrate dev --name <マイグレーション名>

実行すると、以下のような構成で SQLファイルが生成されます。

prisma/
└── migrations/
└── [日付]_[マイグレーション名]
└── migration.sql

マイグレーションを行うと、migrationsディレクトリ配下で変更履歴を管理できるだけでなく、ファイルを Git管理することも可能です。
また、構造の再現が容易となるため、特にチーム開発では重要な機能となります。

本番環境のデータベースへ安全に変更を適用するmigrate deployの手順

本番環境でマイグレーションを実行する場合は、以下のコマンドを使用します。

npx prisma migrate deploy

上記コマンドではSQLファイルの新規生成は行わず、未適用の既存ファイルのみマイグレーションを実行します。
一般的な使用の流れは、以下の通りです。

  1. 開発環境でmigrate dev
  2. Gitへコミット
  3. 本番環境へデプロイ
  4. migrate deploy実行

これにより、開発環境と本番環境の差異を防げます。

Prismaとライバル「Drizzle ORM」の比較から考える選定基準

スキーマ定義の記述アプローチと型安全性の思想の違い

近年では、Prismaの他に Drizzle ORMも人気が高くなっています。
両者の特徴的な違いの１つは、スキーマ定義の記述方法にあります。

Prismaのスキーマ定義は、ドメイン特化言語(DSL) で行います。

model User {
  id Int @id
  name String
}

Prismaの型安全性は強力で、スキーマを元に自動で生成されるTypeScriptの型定義ファイルを利用し、クエリを記述する際にTypeScriptのコンパイラが型チェックを行います。
これにより、正確な型推論やエラー検知を可能としています。

一方、Drizzleは TypeScriptで直接スキーマ定義をします。

export const users = pgTable("users", {
  id: serial("id").primaryKey(),
  name: text("name"),
});

Prismaのような生成ステップが必要なく、TypeScriptの型推論を利用するため、リアルタイムで型生成が行われるのが特徴です。
スキーマの反映速度においては、Drizzleの方にやや軍配が上がります。

プロジェクトの規模やパフォーマンス要件に応じた技術選定のポイント

PrismaとDrizzleの全体的な特徴は、それぞれ以下が挙げられます。

Prisma:
・学習コストが低い
・ドキュメントが豊富
・DX重視

Drizzle
・TypeScriptとの一体感が強い
・軽量
・SQLに近い設計

Prismaは DSLの導入により、SQL操作に慣れていないユーザーでも記述しやすく、簡潔なコードを可能としています。
Drizzleは反対に、SQLに近い操作を可能とするため、複雑なクエリの調整も行いやすい傾向にあります。

開発環境などに合わせた選定は、以下を基準にすると行いやすいでしょう。

Prismaが向くケース:
・SQL経験者が少ない
・チーム開発などでマイグレーション管理が重要である
・開発効率を重視したい

Drizzleが向くケース:
・SQLを積極的に活用したい
・パフォーマンスやバンドルサイズを重視したい
・ORMの抽象化を最小限にしたい

まとめ

PrismaはTypeScriptとの相性が非常に良く、型安全なデータベース操作を実現できるモダンなORMです。
Web開発における生産性と保守性を大きく向上させるため、これからORMを学ぶ開発者にとって最有力候補の一つと言えるでしょう。

     

Otherカテゴリの最新記事