🌱 Prisma란?

Prisma는 현대적인 TypeScript 기반 ORM(Object-Relational Mapping) 기능을 제공하는 툴이자 라이브러리로, 객체지향 코드로 데이터베이스를 쉽게 다룰 수 있도록 도와줍니다.
SQL 작성 없이도 데이터에 접근하고 조작할 수 있으며, 타입 안전성과 자동완성 기능을 제공합니다.

❓ 툴과 라이브러리의 차이

구분	라이브러리	툴 (Tool, CLI 도구)
목적	코드 내부에서 기능을 불러와 사용	외부에서 작업을 수행하거나 자동화
예시	@prisma/client, lodash, axios	npx prisma migrate, git, webpack
사용 위치	코드 안 (import해서 사용)	터미널이나 명령어 환경에서 사용
기능	DB 요청, 데이터 처리 등 런타임 로직	DB 마이그레이션, 코드 생성, 초기화 작업 등

💡 Extendsion 설치 권장

• 설치 하지 않을 시 shema.prisma - code들의 색이 흰색으로 나옵니다.
  

✅ Prisma의 주요 장점

항목	설명
타입 안정성	DB 모델 기반으로 자동 타입 생성되어 코드 작성 중 오류 예방
간결한 문법	메서드 체이닝 방식으로 직관적인 쿼리 작성 가능
자동 마이그레이션	Prisma CLI로 스키마 변경 → 마이그레이션 자동 생성
프론트엔드 친화적	Next.js 등 TypeScript 기반 프로젝트와 궁합이 매우 좋음
빠른 생산성	Prisma Studio를 통해 GUI로 데이터 확인 및 수정 가능

⚠️ Prisma의 단점

항목	설명
복잡한 쿼리에 한계	복잡한 join/subquery는 native SQL로 처리해야 함
관계 매핑 표현의 제약	일부 고급 관계 설정은 표현이 다소 제한적일 수 있음
런타임 성능 오버헤드	내부 추상화(abstraction) 구조로 성능 이슈 발생 가능 (극단적 경우)

🔧 기본 사용법

1.설치

npm install prisma tsx --save-dev
npx prisma init
npm install @prisma/client

prisma init 실행 시 prisma/schema.prisma 파일과 .env 파일이 생성됨.

2. 데이터베이스 연결 설정

.env 파일에서 DB 연결 문자열을 설정합니다.
DATABASE_URL="postgresql://user:password@localhost:5432/mydb"

✅ DB 문자열(DATABASE_URL 찾는 방법) supabase 기준

1. https://supabase.com/ 접속
2. 회원가입 및 로그인
3. project 생성
4. 상단 우측 Connect 클릭
5. ORMs 클릭
6. 복사후 .env에 복사
   (2025.06.10 기준 ❌conntetion string으로 하면 에러❌)

3. 모델 정의 (schema.prisma)

모델 정의의 자세한 방법은 여기서 알아보겠습니다.

model User {
  id    Int     @id @default(autoincrement())
  name  String
  email String  @unique
  posts Post[]
}

model Post {
  id      Int    @id @default(autoincrement())
  title   String
  content String?
  author  User   @relation(fields: [authorId], references: [id])
  authorId Int
}

4. 마이그레이션 적용

npx prisma migrate dev --name init

DB에 테이블 생성됨
마이그레이션 파일 자동 생성됨

5. Prisma Client 사용 예시

PrismaClient: Prisma가 자동으로 생성한 DB접근 도구, SQL없이 DB를 조작할 수 있게 도와주는 핵심 객체

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

const prisma = new PrismaClient();

async function main() {
// create: instert 쿼리 역할, 현재 post에 새로운 데이터를 넣는 메서드
  const user = await prisma.user.create({
    data: {
      name: '홍길동',
      email: 'hong@example.com',
      posts: {
        create: {
          title: '첫 번째 게시물',
        },
      },
    },
  });
// findMany: select 쿼리 역할, 데이터 여러 개 조회, 조건을 넣으면 필터링도 가능 
  const allUsers = await prisma.user.findMany({
  // include: join의 역할, 현재 usser를 찾을때 연관된 posts도 함께 가져와줘 라는 의미
    include: {
      posts: true,
    },
  });

  console.log(allUsers);
}

// 실제로 실행
main();

🖥️ 주요 터미널 명령어

명령어	설명
npx prisma init	초기 설정 파일 생성
npx prisma generate	Prisma Client 재생성 (모델 변경 시 필요)
npx prisma migrate dev (--name [설명])	개발용 마이그레이션 수행- prisma 스키마 변경-> DB에 반영
npx prisma studio	웹 기반 GUI(DB 브라우저) 실행
npx prisma format	schema.prisma 파일 포맷 정리(포맷팅): 가독성 증가
npx prisma db pull	기존 DB에서 스키마 불러오기- DB 변경-> Prisma 스키마 반영 (반대로 가져오기)
npx prisma migrate reset	🚨 기존 DB 초기화(Shema 포함 데이터 유실, 주의해서 사용)

🗂 SQL vs Prisma 문법 비교

작업	SQL	Prisma
✅ 데이터 생성 (INSERT)	INSERT INTO users (name, email) VALUES ('홍길동', 'hong@example.com');	await prisma.user.create({ data: { name: '홍길동', email: 'hong@example.com' } });
🔍 전체 조회 (SELECT all)	SELECT * FROM users;	await prisma.user.findMany();
🔍 조건 조회 (SELECT with WHERE)	SELECT * FROM users WHERE email = 'hong@example.com';	await prisma.user.findMany({ where: { email: 'hong@example.com' } });
✍️ 수정 (UPDATE)	UPDATE users SET name = '김철수' WHERE id = 1;	await prisma.user.update({ where: { id: 1 }, data: { name: '김철수' } });
❌ 삭제 (DELETE)	DELETE FROM users WHERE id = 1;	await prisma.user.delete({ where: { id: 1 } });
🔗 조인 포함 조회 (JOIN)	SELECT * FROM users u JOIN posts p ON u.id = p.user_id;	await prisma.user.findMany({ include: { posts: true } });
🧵 관계 포함 생성 (user와 post 함께 생성)	INSERT INTO users ...; INSERT INTO posts (user_id, title) VALUES (...);	await prisma.user.create({ data: { name: '', posts: { create: { title: '' } } } });
🔄 Upsert (있으면 수정, 없으면 생성)	(SQL은 복잡한 조건문 필요)	await prisma.user.upsert({ where: { email }, update: { name }, create: { email, name } });

📦 Prisma 주요 메서드 정리
🔹 Create (데이터 생성)

메서드	설명
create()	단일 레코드 생성
createMany()	여러 레코드 한 번에 생성

🔍 Read (데이터 조회)

메서드	설명
findUnique()	고유 조건으로 단일 레코드 조회 (e.g. id)
findFirst()	조건에 맞는 첫 번째 레코드 조회
findMany()	여러 레코드 조회
count()	조건에 맞는 레코드 수 반환
aggregate()	sum, avg, max, min, count 등 집계 함수
groupBy()	필드 기준으로 그룹화하여 통계 계산

✏️ Update (데이터 수정)

메서드	설명
update()	단일 레코드 수정
updateMany()	조건에 맞는 여러 레코드 수정

🔁 Upsert (조건부 삽입 or 수정)

메서드	설명
upsert()	존재하면 update, 없으면 create 수행

💡 기타 유용한 기능

메서드	설명
include	관계 테이블 같이 조회할 때 사용
select	필요한 필드만 선택해서 조회할 때 사용
orderBy	정렬
where	조건 지정
distinct	중복 제거