NestJS mengintegrasikan dengan clean dengan database melalui ORM — paling umum TypeORM (integrasi resmi @nestjs/typeorm) dan Prisma (ORM modern, type-safe yang digunakan melalui layanan khusus). Keduanya cocok dengan struktur module/provider/DI NestJS.
({
: [
.({
: ,
: 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 menggunakan class @Entity (dipetakan ke tabel) dan Repositorys yang dapat disuntikkan untuk kueri — cocok dengan model DI NestJS secara alami melalui @InjectRepository.
// 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 menghasilkan klien yang sepenuhnya type-safe dari file skema; Anda membungkusnya dalam PrismaService yang dapat disuntikkan dan menggunakannya di layanan Anda.
⚠️ 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
Integrasi database sangat penting — hampir setiap back-end menyimpan data, dan memahami cara menghubungkan database ke NestJS dengan cara idiomatis adalah pengetahuan praktis inti.
Kedua ORM utama cocok dengan arsitektur NestJS secara bersih: TypeORM melalui modul resmi @nestjs/typeorm (mengonfigurasi koneksi, mendefinisikan class @Entity, menyuntikkan Repositorys melalui DI) dan Prisma melalui PrismaService yang dapat disuntikkan dan terbungkus (memberikan keamanan tipe yang sangat baik).
Mengetahui cara menyiapkan koneksi, mendefinisikan model, dan menyuntikkan lapisan akses data ke dalam layanan — menjaga logika database di layanan, terpisah dari controller — adalah fundamental untuk membangun aplikasi NestJS yang sebenarnya.
Secara kritis, memahami prinsip migrasi-daripada-synchronize (tidak pernah auto-sync skema dalam produksi, di mana dapat merusak data, tetapi menggunakan migrasi yang dikontrol versi) adalah praktik keamanan produksi yang penting.
Ini adalah materi harian yang wajib diketahui, karena persistensi data adalah sentral untuk pengembangan back-end dan integrasi ORM adalah cara aplikasi NestJS benar-benar menyimpan dan mengambil data mereka.