NestJS에 데이터베이스(TypeORM/Prisma)를 어떻게 통합하나요?

Question

Accepted Answer

NestJS는 ORM을 통해 데이터베이스와 깔끔하게 통합됩니다 — 가장 흔하게는 **TypeORM**(공식 `@nestjs/typeorm` 통합)과 **Prisma**(커스텀 service를 통해 사용되는 현대적이고 타입 안전한 ORM)입니다. 둘 다 NestJS의 module/provider/DI 구조에 맞습니다. ## TypeORM 통합 ```ts // 1. module에서 연결 구성 @Module({ imports: [ TypeOrmModule.forRoot({ type: "postgres", url: process.env.DATABASE_URL, entities: [User], synchronize: false, // ⚠️ 프로덕션에서 절대 true 금지 (migration 사용) }), TypeOrmModule.forFeature([User]), // 이 기능 module에 entity 등록 ], }) export class UsersModule {} ``` ```ts // 2. entity 정의 (테이블에 매핑) @Entity() export class User { @PrimaryGeneratedColumn() id: number; @Column() name: string; @Column({ unique: true }) email: string; } ``` ```ts // 3. service에 repository 주입 @Injectable() export class UsersService { constructor( @InjectRepository(User) private usersRepo: Repository, ) {} findAll() { return this.usersRepo.find(); } findOne(id: number) { return this.usersRepo.findOneBy({ id }); } create(data: Partial) { return this.usersRepo.save(data); } } ``` TypeORM은 `@Entity` 클래스(테이블에 매핑됨)와 쿼리를 위한 주입 가능한 `Repository`를 사용합니다 — `@InjectRepository`를 통해 NestJS의 DI 모델에 자연스럽게 맞습니다. ## Prisma 통합 ```ts // 1. PrismaService가 Prisma 클라이언트를 감싸고 연결 생명주기 관리 @Injectable() export class PrismaService extends PrismaClient implements OnModuleInit { async onModuleInit() { await this.$connect(); } // 시작 시 연결 } ``` ```ts // 2. 주입하여 타입 안전한 클라이언트 사용 @Injectable() export class UsersService { constructor(private prisma: PrismaService) {} findAll() { return this.prisma.user.findMany(); } findOne(id: number) { return this.prisma.user.findUnique({ where: { id } }); } create(data) { return this.prisma.user.create({ data }); } } ``` Prisma는 스키마 파일에서 완전히 타입 안전한 클라이언트를 생성합니다. 이를 주입 가능한 `PrismaService`로 감싸 service에서 사용합니다. ## synchronize보다 migration ```text ⚠️ 프로덕션에서 `synchronize: true`(TypeORM)를 절대 사용하지 마세요 — 스키마를 자동으로 변경하고 데이터를 DROP할 수 있습니다. 대신 MIGRATION(버전 관리되는 스키마 변경)을 사용하세요. Prisma: prisma migrate dev/deploy가 migration 파일을 통해 스키마 변경을 관리합니다. ``` ## TypeORM 대 Prisma ```text TypeORM → repository/active-record 패턴, decorator, 성숙함, 공식 Nest 통합 Prisma → 스키마 우선, 뛰어난 타입 안전성, 훌륭한 DX, 인기 상승 중 ``` ## 왜 중요한가 데이터베이스 통합은 필수적입니다 — 거의 모든 백엔드가 데이터를 영속화하며, 데이터베이스를 NestJS에 관용적인 방식으로 연결하는 방법을 이해하는 것은 핵심 실무 지식입니다. 두 주요 ORM 모두 NestJS 아키텍처에 깔끔하게 맞습니다: TypeORM은 공식 `@nestjs/typeorm` module을 통해(연결 구성, `@Entity` 클래스 정의, DI를 통한 `Repository` 주입), Prisma는 감싼 주입 가능한 `PrismaService`를 통해(뛰어난 타입 안전성 제공). 연결을 설정하고, 모델을 정의하고, 데이터 접근 계층을 service에 주입하는 방법 — 데이터베이스 로직을 controller와 분리하여 service에 유지 — 을 아는 것은 실제 NestJS 애플리케이션을 구축하는 데 기본적입니다. 결정적으로, **synchronize보다 migration** 원칙(프로덕션에서 스키마를 자동 동기화하지 않음 — 데이터를 파괴할 수 있음 — 대신 버전 관리되는 migration 사용)을 이해하는 것은 중요한 프로덕션 안전 실무입니다. 데이터 영속화가 백엔드 개발의 중심이고 ORM 통합이 NestJS 앱이 실제로 데이터를 저장하고 검색하는 방법이므로, 이는 일상적이고 반드시 알아야 할 자료입니다.