NestJS berintegrasi dengan kemas dengan database melalui ORM — paling lazim TypeORM (integrasi rasmi @nestjs/typeorm) dan Prisma (sebuah ORM moden yang selamat-jenis, digunakan melalui satu custom service). Kedua-duanya muat 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 kelas @Entity (dipetakan kepada jadual) dan Repository yang boleh disuntik untuk query — muat secara semula jadi dengan model DI NestJS 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 menjana satu client yang sepenuhnya selamat-jenis daripada satu fail schema; anda membalutnya dalam satu PrismaService yang boleh disuntik dan menggunakannya dalam services 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 adalah penting — hampir setiap back-end menyimpan data secara berterusan, dan memahami cara menyambungkan database kepada NestJS mengikut cara idiomatik ialah pengetahuan praktikal yang teras.
Kedua-dua ORM utama muat dengan kemas dengan seni bina NestJS: TypeORM melalui module rasmi @nestjs/typeorm (mengkonfigurasi sambungan, mentakrifkan kelas @Entity, menyuntik Repository melalui DI) dan Prisma melalui satu PrismaService terbalut yang boleh disuntik (memberikan keselamatan jenis yang sangat baik).
Mengetahui cara menyediakan sambungan, mentakrifkan model, dan menyuntik lapisan akses-data ke dalam services — mengekalkan logik database dalam services, diasingkan daripada controllers — adalah asas untuk membina aplikasi NestJS sebenar.
Yang kritikal, memahami prinsip migrations-berbanding-synchronize (tidak sekali-kali auto-sync schema dalam production, di mana ia boleh memusnahkan data, tetapi sebaliknya menggunakan migrations yang dikawal versi) ialah satu amalan keselamatan production yang penting.
Ini ialah bahan sehari-hari yang mesti diketahui, kerana kegigihan data adalah pusat kepada pembangunan back-end dan integrasi ORM ialah cara aplikasi NestJS sebenarnya menyimpan dan mendapatkan semula datanya.