كيف تدمج قاعدة بيانات (TypeORM/Prisma) مع NestJS؟

Question

Accepted Answer

يدمج NestJS قواعد البيانات بسلاسة عبر ORMs — الأكثر شيوعاً **TypeORM** (التكامل الرسمي `@nestjs/typeorm`) و**Prisma** (ORM حديث وآمن للأنواع يُستخدم عبر خدمة مخصصة). كلاهما يناسب بنية 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 القابلة للحقن للاستعلامات — مناسبة بشكل طبيعي لنموذج حقن التبعيات في 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 عميلاً آمناً للأنواع بالكامل من ملف المخطط؛ تغلفه في `PrismaService` قابلة للحقن وتستخدمه في خدماتك. ## المتغيرات بدلاً من المزامنة ```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 مقابل 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` (تكوين الاتصالات وتعريف فئات `@Entity` وحقن `Repository`s عبر حقن التبعيات) و Prisma عبر `PrismaService` قابلة للحقن المغلفة (مما يوفر سلامة نوع ممتازة). معرفة كيفية إعداد الاتصال وتعريف النماذج وحقن طبقة الوصول إلى البيانات في الخدمات — مع الاحتفاظ بمنطق قاعدة البيانات في الخدمات بعيداً عن المتحكمات — أساسية لبناء تطبيقات NestJS الحقيقية. non بشكل حاسم، فهم مبدأ **المتغيرات-بدلاً-من-المزامنة** (عدم المزامنة التلقائية للمخطط في الإنتاج، حيث يمكنه تدمير البيانات، بل استخدام متغيرات خاضعة للتحكم بالإصدار) هو ممارسة أمان إنتاج مهمة. هذا مادة يومية ويجب معرفتها، لأن استمرار البيانات أساسي لتطوير back-end وتكامل ORM هو كيفية قيام تطبيقات NestJS فعلاً بتخزين واسترجاع بيانات.