Come integri un database (TypeORM/Prisma) con NestJS?

Question

Accepted Answer

NestJS si integra in modo pulito con i database tramite ORM — più comunemente **TypeORM** (integrazione ufficiale `@nestjs/typeorm`) e **Prisma** (un ORM moderno, type-safe utilizzato tramite un servizio personalizzato). Entrambi si adattano perfettamente alla struttura module/provider/DI di NestJS. ## TypeORM integration ```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 usa classi `@Entity` (mappate a tabelle) e `Repository`s iniettabili per le query — si adatta naturalmente al modello DI di NestJS tramite `@InjectRepository`. ## Prisma integration ```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 genera un client completamente type-safe da un file schema; lo avvolgi in un `PrismaService` iniettabile e lo utilizzi nei tuoi servizi. ## Migrations over 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 vs Prisma ```text TypeORM → repository/active-record patterns, decorators, mature, official Nest integration Prisma → schema-first, excellent type safety, great DX, growing popularity ``` ## Perché è importante L'integrazione del database è essenziale — quasi ogni back-end persiste dati, e comprendere come connettere un database a NestJS in modo idiomatico è conoscenza pratica fondamentale. Entrambi gli ORM principali si adattano perfettamente all'architettura di NestJS: TypeORM tramite il modulo ufficiale `@nestjs/typeorm` (configurando connessioni, definendo classi `@Entity`, iniettando `Repository`s attraverso il DI) e Prisma tramite un `PrismaService` iniettabile avvolto (garantendo eccellente type safety). Sapere come configurare la connessione, definire modelli e iniettare il layer di accesso ai dati nei servizi — mantenendo la logica del database nei servizi, separata dai controller — è fondamentale per costruire applicazioni NestJS reali. Criticamente, comprendere il principio **migrations-over-synchronize** (non sincronizzare mai automaticamente lo schema in produzione, dove potrebbe distruggere i dati, ma utilizzare invece migrazioni versionabili) è una pratica importante per la sicurezza in produzione. Questo è materiale quotidiano e essenziale da conoscere, poiché la persistenza dei dati è centrale nello sviluppo back-end e l'integrazione ORM è come le applicazioni NestJS effettivamente archiviano e recuperano i loro dati.