Prisma ORM 설정
다양한 데이터베이스와 상호작용할 수 있도록 Prisma ORM을 Next.js 프로젝트에 구성하고 통합합니다.
Prisma ORM 설정은(는) CoddyKit의 무료 Next.js 15 Fullstack (App Router + Server Actions) 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 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/clientInitialize 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 initConnect 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 (usuallyprisma-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 generateApplying 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 initUsing 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/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Next.js 15 Fullstack (App Router + Server Actions) 강의 전체를 잠금 해제할 수 있습니다. Next.js 15 Fullstack (App Router + Server Actions) 강의에는 총 4개의 강의가 포함되어 있습니다.
“Prisma ORM 설정”에서 뭘 배우나요?
다양한 데이터베이스와 상호작용할 수 있도록 Prisma ORM을 Next.js 프로젝트에 구성하고 통합합니다. 브라우저에서 직접 실행하는 실습 코드로 Next.js 15 Fullstack (App Router + Server Actions)을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Next.js 15 Fullstack (App Router + Server Actions)을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Next.js 15 Fullstack (App Router + Server Actions)은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“Prisma ORM 설정” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Next.js 15 Fullstack (App Router + Server Actions) 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Next.js 15 Fullstack (App Router + Server Actions) 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.