NestJS tích hợp gọn gàng với database qua các ORM — phổ biến nhất là TypeORM (tích hợp chính thức @nestjs/typeorm) và Prisma (một ORM hiện đại, an toàn kiểu, được dùng qua một custom service). Cả hai đều phù hợp với cấu trúc module/provider/DI của NestJS.
({
: [
.({
: ,
: process..,
: [],
: ,
}),
.([]),
],
})
{}
// 2. định nghĩa một entity (ánh xạ tới một bảng)
@Entity()
export class User {
@PrimaryGeneratedColumn() id: number;
@Column() name: string;
@Column({ unique: true }) email: string;
}
// 3. inject repository vào một 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 dùng các class @Entity (ánh xạ tới bảng) và các Repository có thể inject để truy vấn — phù hợp tự nhiên với model DI của NestJS qua @InjectRepository.
// 1. một PrismaService bọc Prisma client (và quản lý vòng đời kết nối)
@Injectable()
export class PrismaService extends PrismaClient implements OnModuleInit {
async onModuleInit() { await this.$connect(); } // kết nối lúc khởi động
}
// 2. inject nó và dùng client an toàn kiểu
@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 sinh một client hoàn toàn an toàn kiểu từ một file schema; bạn bọc nó trong một PrismaService có thể inject và dùng nó trong các service của bạn.
⚠️ KHÔNG BAO GIỜ dùng `synchronize: true` (TypeORM) trong production — nó tự động sửa schema
của bạn và có thể XÓA dữ liệu. Dùng MIGRATION (thay đổi schema có version control) thay thế.
Prisma: prisma migrate dev/deploy quản lý thay đổi schema qua các file migration.
TypeORM → pattern repository/active-record, decorator, trưởng thành, tích hợp Nest chính thức
Prisma → schema-first, an toàn kiểu xuất sắc, DX tuyệt vời, ngày càng phổ biến
Tích hợp database là thiết yếu — gần như mọi back-end đều lưu trữ dữ liệu, và hiểu cách kết nối một database với NestJS theo cách thành ngữ là kiến thức thực hành cốt lõi.
Cả hai ORM lớn đều phù hợp với kiến trúc NestJS gọn gàng: TypeORM qua module chính thức @nestjs/typeorm (cấu hình kết nối, định nghĩa các class @Entity, inject các Repository qua DI) và Prisma qua một PrismaService có thể inject được bọc lại (cho an toàn kiểu xuất sắc).
Biết cách thiết lập kết nối, định nghĩa model, và inject lớp truy cập dữ liệu vào các service — giữ logic database trong các service, tách biệt khỏi controller — là nền tảng để xây dựng các ứng dụng NestJS thực tế.
Quan trọng nhất, hiểu nguyên tắc migration thay vì synchronize (không bao giờ tự động đồng bộ schema trong production, nơi nó có thể phá hủy dữ liệu, mà thay vào đó dùng các migration có version control) là một thông lệ an toàn production quan trọng.
Đây là tài liệu hằng ngày, phải biết, vì lưu trữ dữ liệu là trung tâm của phát triển back-end và tích hợp ORM là cách các ứng dụng NestJS thực sự lưu trữ và truy xuất dữ liệu của chúng.