NestJS integruje się elegancko z bazami danych poprzez ORMy — najczęściej TypeORM (oficjalna integracja @nestjs/typeorm) i Prisma (nowoczesny, typowo-bezpieczny ORM wykorzystywany poprzez niestandardową usługę). Oba pasują do struktury moduł/provider/DI w 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 używa klas @Entity (mapowanych na tabele) i injectowalnych Repository do zapytań — naturalnie pasuje do modelu DI w NestJS poprzez @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 w pełni typowo-bezpieczny klient ze schematu; opakowujesz go w injectowalne PrismaService i używasz w swoich serwisach.
⚠️ 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
Integracja bazy danych jest niezbędna — prawie każda back-endowa aplikacja przechowuje dane, a zrozumienie sposobu idioMatycznego połączenia bazy danych z NestJS jest podstawową wiedzą praktyczną.
Oba główne ORMy pasują czysto do architektury NestJS: TypeORM poprzez oficjalny moduł @nestjs/typeorm (konfiguracja połączeń, definiowanie klas @Entity, injectowaie Repository poprzez DI) i Prisma poprzez opakowany injectowalny PrismaService (zapewniający doskonałą typową bezpieczeństwo).
Wiedzenie, jak skonfigurować połączenie, definiować modele i injectować warstwę dostępu do danych w serwisy — utrzymując logikę bazy danych w serwisach, oddzielnie od kontrolerów — jest fundamentalne do budowania rzeczywistych aplikacji NestJS.
Krytycznie ważne jest zrozumienie zasady migracji zamiast synchronizacji (nigdy nie auto-synchronizuj schematu w produkcji, gdzie może to zniszczyć dane, ale zamiast tego używaj wersjonowanych migracji) — to ważna praktyka bezpieczeństwa produkcyjnego.
To materiał na co dzień, który trzeba znać, ponieważ trwałość danych jest centralna dla rozwoju back-endowego, a integracja ORM to sposób, w jaki aplikacje NestJS faktycznie przechowują i pobierają swoje dane.