NestJS čistě integruje databáze přes ORM — nejčastěji TypeORM (oficiální integrace @nestjs/typeorm) a Prisma (moderní, typově bezpečný ORM používaný přes vlastní službu). Obě se dobře hodí do modulární/poskytovatelské/DI struktury 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 používá @Entity třídy (mapované na tabulky) a injektovatelné Repository pro dotazy — přirozeně se hodí k DI modelu NestJS přes @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 generuje plně typově bezpečného klienta ze souboru schématu; zabalíte jej do injektovatelné PrismaService a použijete jej v Services.
⚠️ 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
Integrace databáze je nezbytná — téměř každý back-end trvale ukládá data, a pochopení toho, jak připojit databázi k NestJS idiomaticky, je základní praktické znalosti.
Obě hlavní ORM se čistě hodí do architektury NestJS: TypeORM přes oficiální modul @nestjs/typeorm (konfigurace připojení, definování @Entity tříd, injektování Repository přes DI) a Prisma přes zabalená injektovatelná PrismaService (poskytující vynikající typovou bezpečnost).
Vědět, jak nastavit připojení, definovat modely a injektovat vrstvu přístupu k datům do služeb — udržovat logiku databáze v Services oddělená od kontrolérů — je fundamentální pro vytváření skutečných NestJS aplikací.
Kriticky, pochopení principu migrace-místo-synchronizace (nikdy automatická synchronizace schématu v produkci, kde by mohla zničit data, ale místo toho použití verzí kontrolovaných migrací) je důležitá praktika bezpečnosti v produkci.
Toto je každodenní, musí-se-znát materiál, protože trvalost dat je ústředná pro vývoj back-endu a integrace ORM je způsob, jakým NestJS aplikace skutečně ukládají a načítají svá data.