Πώς ενσωματώνετε μια βάση δεδομένων (TypeORM/Prisma) με το NestJS;

Question

Accepted Answer

Το NestJS ενσωματώνει καθαρά τις βάσεις δεδομένων μέσω ORMs — συνηθέστερα **TypeORM** (αρχική ενσωμάτωση `@nestjs/typeorm`) και **Prisma** (ένα σύγχρονο, type-safe ORM που χρησιμοποιείται μέσω ενός προσαρμοσμένου service). Και τα δύο ταιριάζουν φυσικά στη δομή module/provider/DI του NestJS. ## Ενσωμάτωση 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 χρησιμοποιεί κλάσεις `@Entity` (αντιστοιχισμένες σε πίνακες) και ενόσιμα `Repository`s για queries — ταιριάζουν φυσικά στο DI μοντέλο του NestJS μέσω `@InjectRepository`. ## Ενσωμάτωση 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 δημιουργεί έναν πλήρως type-safe client από ένα αρχείο σχήματος· το τυλίγετε σε ένα ενόσιμο `PrismaService` και το χρησιμοποιείτε στα services σας. ## Μετανάστευση αντί για συγχρονισμό ```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 ``` ## Γιατί έχει σημασία Η ενσωμάτωση βάσης δεδομένων είναι απαραίτητη — σχεδόν κάθε back-end διατηρεί δεδομένα, και η κατανόηση του τρόπου σύνδεσης μιας βάσης δεδομένων με το NestJS με τη συμβατική τρόπο είναι ουσιαστική πρακτική γνώση. Και τα δύο κύρια ORMs ταιριάζουν καθαρά στην αρχιτεκτονική του NestJS: TypeORM μέσω του επίσημου `@nestjs/typeorm` module (διαμόρφωση συνδέσεων, ορισμός κλάσεων `@Entity`, ένωση `Repository`s μέσω DI) και Prisma μέσω ενός τυλιγμένου ενόσιμου `PrismaService` (που παρέχει εξαιρετική type safety). Το να γνωρίζετε πώς να ρυθμίσετε τη σύνδεση, να ορίσετε μοντέλα και να ενώσετε το data-access layer σε services — διατηρώντας τη λογική της βάσης δεδομένων σε services, ξεχωριστή από controllers — είναι θεμελιώδες για τη δημιουργία πραγματικών εφαρμογών NestJS. Κριτικά, η κατανόηση της αρχής **migrations-over-synchronize** (ποτέ auto-syncing του σχήματος σε production, όπου μπορεί να καταστρέψει δεδομένα, αλλά αντ' αυτού χρησιμοποιώντας version-controlled migrations) είναι μια σημαντική πρακτική παραγωγής ασφάλειας. Αυτό είναι καθημερινό, πρέπει-να-γνωρίζετε υλικό, καθώς η επιμονή δεδομένων είναι κεντρική για την ανάπτυξη back-end και η ενσωμάτωση ORM είναι ο τρόπος που πραγματικά αποθηκεύουν και ανακτούν τα δεδομένα τους οι εφαρμογές NestJS.