Next.js 15 Fullstack (App Router + Server Actions) · レッスン

Prisma ORMのセットアップ

Next.jsプロジェクトにPrisma ORMを設定・統合し、さまざまなデータベースと連携します

「Prisma ORMのセットアップ」はCoddyKit上の無料Next.js 15 Fullstack (App Router + Server Actions)レッスンです。これはレッスン1/4です。下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。これはNext.js 15 Fullstack (App Router + Server Actions)学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Next.js 15 Fullstack (App Router + Server Actions)コースには全4レッスンが含まれています。

このレッスンの一部はまだ翻訳されておらず、英語で表示されています。

What is an ORM?

Welcome! In this lesson, we'll set up Prisma ORM in a Next.js project. But first, what's an ORM?

ORM stands for Object-Relational Mapping.
It's a technique that lets you interact with your database using your programming language's objects instead of writing raw SQL.
Think of it as a translator between your code (e.g., JavaScript objects) and your database (e.g., SQL tables).

Why Choose Prisma?

Prisma is a modern ORM that's popular with Next.js for good reasons:

Type Safety: It generates a type-safe client, preventing many runtime errors.
Developer Experience: Intuitive API, powerful migrations, and automatic code completion.
Modern Stack: Designed for TypeScript and modern JavaScript, fitting perfectly with Next.js.
Database Support: Works with PostgreSQL, MySQL, SQLite, SQL Server, and MongoDB.

Installing Prisma

Let's start by adding Prisma to your Next.js project. You'll need two main packages:

prisma: The Prisma CLI (Command Line Interface) for development tasks.
@prisma/client: The Prisma Client library for interacting with your database in code.

Run this command in your project's root:

npm install prisma @prisma/client

Initialize Prisma

After installation, you need to initialize Prisma in your project. This command sets up the basic Prisma structure, including the prisma/schema.prisma file.

It also creates a .env file to hold your database connection string.

npx prisma init

Connect Your Database

The .env file created by prisma init contains a DATABASE_URL variable. This is where you tell Prisma how to connect to your database.

For local development, SQLite is often used for simplicity. For production, you might use PostgreSQL or MySQL.

# .env
DATABASE_URL="postgresql://user:password@host:port/database?schema=public"

# Example for SQLite (local file)
# DATABASE_URL="file:./dev.db"

The Prisma Schema File

Your prisma/schema.prisma file is the heart of your Prisma setup. It defines three key blocks:

datasource: Specifies your database provider (e.g., postgresql, sqlite).
generator: Configures the Prisma Client (usually prisma-client-js).
model: Defines your database tables (models) and their fields.

Defining Your First Model

Let's define a simple User model in your prisma/schema.prisma file. This model will represent a table in your database.

id: Unique identifier, auto-incrementing.
email: User's email, must be unique.
name: User's name, optional.

// prisma/schema.prisma

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

Generating Prisma Client

After defining or changing your models in schema.prisma, you must generate the Prisma Client. This command reads your schema and creates the type-safe client library.

This client is what you'll import and use in your Next.js application to interact with your database.

npx prisma generate

Applying Migrations

To create or update your database tables based on your schema.prisma, you use migrations. The migrate dev command:

Compares your schema to the database.
Generates SQL migration files.
Applies these migrations to your database.

It also generates the Prisma Client automatically after migration.

npx prisma migrate dev --name init

Using Prisma Client

Once Prisma is set up and generated, you can use the PrismaClient in your Next.js server components or API routes to perform database operations. Here's a basic example:

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

async function main() {
  const prisma = new PrismaClient();
  console.log("Prisma Client successfully initialized!");

  // In a real app, you'd perform database operations:
  // const users = await prisma.user.findMany();
  // console.log(users);

  await prisma.$disconnect();
  console.log("Prisma Client disconnected.");
}

main().catch(console.error);

Quick Check: Prisma Commands

You've learned about several key Prisma CLI commands. Which command is used to generate the type-safe Prisma Client after you've modified your schema.prisma file?

Recap: Setting Up Prisma

Great job! You've learned the essential steps to integrate Prisma ORM into your Next.js project:

Installed Prisma CLI and client.
Initialized Prisma and configured your database URL.
Defined data models in schema.prisma.
Generated the Prisma Client.
Applied migrations to sync your schema with the database.
Understood how to instantiate and use PrismaClient.

Next, we'll dive into performing CRUD operations with Prisma!

よくある質問

「Prisma ORMのセットアップ」レッスンは無料ですか？

はい。「Prisma ORMのセットアップ」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Next.js 15 Fullstack (App Router + Server Actions)コースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Next.js 15 Fullstack (App Router + Server Actions)コースには全4レッスンが含まれています。

「Prisma ORMのセットアップ」で何を学びますか？

Next.jsプロジェクトにPrisma ORMを設定・統合し、さまざまなデータベースと連携しますブラウザで直接実行するハンズオンコードでNext.js 15 Fullstack (App Router + Server Actions)を演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

Next.js 15 Fullstack (App Router + Server Actions)を始めるのに経験は必要ですか？

事前経験は必要ありません。CoddyKitのNext.js 15 Fullstack (App Router + Server Actions)は初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。これはレッスン1/4です。

「Prisma ORMのセットアップ」レッスンにはどのくらい時間がかかりますか？

ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このNext.js 15 Fullstack (App Router + Server Actions)レッスンでコードを書いて実行できますか？

はい。すべてのNext.js 15 Fullstack (App Router + Server Actions)レッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

← Next.js 15 Fullstack (App Router + Server Actions)に戻る