Hogyan integrálsz adatbázist (TypeORM/Prisma) a NestJS-sel?

Question

Accepted Answer

A NestJS tisztán integrálódik az adatbázisokkal az ORM-eken keresztül — leggyakrabban a **TypeORM** (a hivatalos `@nestjs/typeorm` integráció) és a **Prisma** (egy modern, type-safe ORM, amelyet egy egyéni szolgáltatáson keresztül használnak). Mindkettő természetesen illeszkedik a NestJS modul/provider/DI szerkezetéhez. ## TypeORM integráció ```ts // 1. configure the connection in a module @Module({ imports: [ TypeOrmModule.forRoot({ type: "postgres", url: process.env.DATABASE_URL, entities: [User], synchronize: false, // ⚠️ NEVER true in production (use migrations) }), TypeOrmModule.forFeature([User]), // register entities for this feature module ], }) export class UsersModule {} ``` ```ts // 2. define an entity (maps to a table) @Entity() export class User { @PrimaryGeneratedColumn() id: number; @Column() name: string; @Column({ unique: true }) email: string; } ``` ```ts // 3. inject the repository into a service @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); } } ``` A TypeORM `@Entity` osztályokat (táblákhoz leképezve) és injektálható `Repository`kat használ a lekérdezésekhez — természetesen illeszkedik a NestJS DI modelljéhez a `@InjectRepository` segítségével. ## Prisma integráció ```ts // 1. a PrismaService wraps the Prisma client (and manages connection lifecycle) @Injectable() export class PrismaService extends PrismaClient implements OnModuleInit { async onModuleInit() { await this.$connect(); } // connect on startup } ``` ```ts // 2. inject it and use the type-safe client @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 }); } } ``` A Prisma egy teljesen type-safe klienst generál egy séma fájlból; becsomagolod egy injektálható `PrismaService`be, és használod a szolgáltatásaidban. ## Migrációk a synchronize helyett ```text ⚠️ NEVER use `synchronize: true` (TypeORM) in production — it auto-alters your schema and can DROP data. Use MIGRATIONS (version-controlled schema changes) instead. Prisma: prisma migrate dev/deploy manages schema changes via migration files. ``` ## TypeORM vs Prisma ```text TypeORM → repository/active-record patterns, decorators, mature, official Nest integration Prisma → schema-first, excellent type safety, great DX, growing popularity ``` ## Miért fontos ez Az adatbázis integráció lényeges — szinte minden back-end adatokat tárol, és annak megértése, hogyan kell az adatbázist a NestJS-sel idiomatikus módon összekapcsolni, az alapvető gyakorlati tudás. Mindkét fő ORM tisztán illeszkedik a NestJS architektúrájához: a TypeORM a hivatalos `@nestjs/typeorm` modulon keresztül (kapcsolatok konfigurálása, `@Entity` osztályok meghatározása, `Repository`k injektálása a DI-n keresztül) és a Prisma egy becsomagolt injektálható `PrismaService`n keresztül (kiváló típusbiztonságot nyújtva). Annak ismerete, hogyan kell beállítani a kapcsolatot, meghatározni a modelleket és injektálni az adatelérési rétegt a szolgáltatásokba — az adatbázis logikát a szolgáltatásokban tartva, elkülönítve a kontrollerektől — alapvető a valós NestJS alkalmazások építéséhez. Szánt fontossággal az **migrációk-helyett-synchronize** elv megértése (soha ne auto-szinkronizáld a sémát éles üzemben, ahol megsemmisíthet adatokat, hanem használj verziókezelted migrációkat) egy fontos éles üzemi biztonsági gyakorlat. Ez napi, nélkülözhetetlen anyag, mivel az adat perzisztencia központi a back-end fejlesztéshez, és az ORM integráció az, ahogy a NestJS alkalmazások valójában tárolják és visszakeresik az adataikat.