Kako integrirati bazu podataka (TypeORM/Prisma) s NestJS-om?

Question

Accepted Answer

NestJS se čisto integrira s bazama podataka putem ORM-a — najčešće **TypeORM** (službena integracija `@nestjs/typeorm`) i **Prisma** (moderan, type-safe ORM korišten kroz prilagođenu uslugu). Oba se prirodno uklapaju u NestJS-ovu strukturu module/provider/DI. ## Integracija TypeORM ```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); } } ``` TypeORM koristi `@Entity` klase (mapirane na tablice) i injicirajuće `Repository`s za upite — prirodno se uklapa u NestJS-ov DI model putem `@InjectRepository`. ## Integracija Prisma ```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 }); } } ``` Prisma genira u potpunosti type-safe klijent iz datoteke sheme; omotate ga u injicirajući `PrismaService` i koristite ga u vašim uslugama. ## Migracije umjesto synchronize ```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 nasuprot Prisma ```text TypeORM → repository/active-record patterns, decorators, mature, official Nest integration Prisma → schema-first, excellent type safety, great DX, growing popularity ``` ## Zašto je to važno Integracija baze podataka je bitna — gotovo svaki back-end čuva podatke, a razumijevanje kako na idiomatski način povezati bazu podataka s NestJS-om je temeljno praktično znanje. Oba glavna ORM-a se čisto uklapaju u NestJS-ovu arhitekturu: TypeORM putem službene `@nestjs/typeorm` module (konfiguriranje veza, definiranje `@Entity` klasa, injiciranje `Repository`s kroz DI) i Prisma putem omotane injicirajuće `PrismaService` (pružajući izvrsnu sigurnost tipova). Znati kako postaviti vezu, definirati modele i injicirati sloj pristupa podacima u usluge — čuvajući logiku baze podataka u uslugama, odvojeno od kontrolera — temeljno je za izgradnju stvarnih NestJS aplikacija. Naročito, razumijevanje principa **migracija-umjesto-synchronize** (nikada ne auto-sinkroniziranje sheme u produkciji, gdje može uništiti podatke, već korištenje verzioniranih migracija) je važna praksa sigurnosti u produkciji. Ovo je svakodnevni, neizostan materijal, jer je trajnost podataka central za back-end razvoj i ORM integracija je način na koji NestJS aplikacije stvarno pohranjuju i dohvaćaju svoje podatke.