NestJS, veritabanlarını ORM'ler aracılığıyla temiz bir şekilde entegre eder — en yaygın olarak TypeORM (resmi @nestjs/typeorm entegrasyonu) ve Prisma (özel bir hizmet aracılığıyla kullanılan modern, tip-güvenli ORM). Her ikisi de NestJS'nin modül/sağlayıcı/DI yapısına uygun olarak çalışır.
({
: [
.({
: ,
: process..,
: [],
: ,
}),
.([]),
],
})
{}
// 2. define an entity (maps to a table)
@Entity()
export class User {
@PrimaryGeneratedColumn() id: number;
@Column() name: string;
@Column({ unique: true }) email: string;
}
// 3. inject the repository into a service
@Injectable()
export class UsersService {
constructor(
@InjectRepository(User) private usersRepo: Repository<User>,
) {}
findAll() { return this.usersRepo.find(); }
findOne(id: number) { return this.usersRepo.findOneBy({ id }); }
create(data: Partial<User>) { return this.usersRepo.save(data); }
}
TypeORM, @Entity sınıflarını (tablolara eşlenen) ve sorgulamak için injectable Repository'leri kullanır — @InjectRepository aracılığıyla NestJS'nin DI modeline doğal olarak uyum sağlar.
// 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
}
// 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, bir şema dosyasından tamamen tip-güvenli bir istemci oluşturur; bunu injectable bir PrismaService'te sarmalarsınız ve hizmetlerinizde kullanırsınız.
⚠️ 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 → repository/active-record patterns, decorators, mature, official Nest integration
Prisma → schema-first, excellent type safety, great DX, growing popularity
Veritabanı entegrasyonu esastır — neredeyse her arka uç veri kalıcılığı sağlar ve bir veritabanını NestJS'ye diyomatik bir şekilde bağlamayı anlamak, temel pratik bilgidir.
Her iki ana ORM da NestJS'nin mimarisine temiz bir şekilde uyum sağlar: TypeORM, resmi @nestjs/typeorm modülü aracılığıyla (bağlantıları yapılandırma, @Entity sınıflarını tanımlama, Repository'leri DI aracılığıyla enjekte etme) ve Prisma, sarmalanmış injectable bir PrismaService aracılığıyla (mükemmel tip güvenliği sağlama).
Bağlantıyı kurma, modelleri tanımlama ve veri erişim katmanını hizmetlere enjekte etme — veritabanı mantığını denetleyicilerden ayrı tutarak hizmetlerde tutma — gerçek NestJS uygulamaları oluştурmanın temeli olduğunu bilmek önemlidir.
Kritikal olarak, göçler-senkronizasyon-yerine ilkesini anlama (üretimde şemayı asla otomatik olarak senkronize etmeme, bu veri kaybına neden olabilir, bunun yerine sürüm kontrollü göçleri kullanma) önemli bir üretim güvenliği uygulamasıdır.
Bu, her gün gerekli olan bilgidir, çünkü veri kalıcılığı arka uç geliştirmesinin merkezinde yer alır ve ORM entegrasyonu, NestJS uygulamalarının verilerini nasıl saklayıp aldığıdır.