NestJS интегрируется с базами данных через ORMs — наиболее часто TypeORM (официальная интеграция @nestjs/typeorm) и Prisma (современный, типобезопасный ORM, используемый через пользовательский сервис). Оба подходят структуре модуль/провайдер/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 использует классы @Entity (отображаемые на таблицы) и инъектируемые Repositorys для запросов — естественно подходит к модели DI в NestJS через @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 генерирует полностью типобезопасный клиент из файла схемы; вы оборачиваете его в инъектируемый PrismaService и используете его в ваших сервисах.
⚠️ 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
Интеграция базы данных является важной — практически каждый back-end сохраняет данные, и понимание того, как подключить базу данных к NestJS идиоматичным способом, является основным практическим знанием.
Оба основных ORM хорошо подходят архитектуре NestJS: TypeORM через официальный модуль @nestjs/typeorm (конфигурирование соединений, определение классов @Entity, инъекция Repositorys через DI) и Prisma через обёрнутый инъектируемый PrismaService (обеспечивающий отличную типобезопасность).
Знание того, как настроить соединение, определить модели и инъектировать слой доступа к данным в сервисы — сохраняя логику базы данных в сервисах, отдельно от контроллеров — является фундаментальным для построения реальных приложений NestJS.
Критически важно понимание принципа миграции вместо синхронизации (никогда не синхронизировать схему автоматически в production, где это может уничтожить данные, но вместо этого использовать версионируемые миграции) — это важная практика безопасности production.
Это ежедневный, обязательный к знанию материал, так как сохранение данных является центральным для back-end разработки, а интеграция ORM — это то, как приложения NestJS фактически сохраняют и извлекают свои данные.