NestJS gražiai integruojasi su duomenų bazėmis per ORM — dažniausiai TypeORM (oficialus @nestjs/typeorm integravimas) ir Prisma (šiuolaikiška, tipo-saugi ORM, naudojama per pasirinktinę paslaugą). Abi tinka NestJS modulio/teikėjo/DI struktūrai.
({
: [
.({
: ,
: 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 naudoja @Entity klases (susietos su lentelėmis) ir injekuojamus Repositorys užklausoms — natūraliai tinkant NestJS DI modeliui per @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 sukuria visiškai tipo-saugų klientą iš schemos failo; jį apvyniosite injekuojamoje PrismaService ir naudosite savo paslaugose.
⚠️ 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
Duomenų bazės integravimas yra būtinas — beveik kiekviena atsarginė sistema išsaugo duomenis, ir supratimas, kaip idiotišku būdu prijungti duomenų bazę prie NestJS, yra pagrindinės praktinės žinios.
Abi pagrindinės ORM gražiai tinka NestJS architektūrai: TypeORM per oficialų @nestjs/typeorm modulį (nustatant ryšius, apibrėžiant @Entity klases, injekuojant Repositorys per DI) ir Prisma per apvyniytą injekuojamą PrismaService (suteikiant puikią tipo saugą).
Žinoti, kaip nustatyti ryšį, apibrėžti modelius ir injekuoti duomenų prieigos sluoksnį į paslaugas — laikant duomenų bazės logiką paslaugose, atskirą nuo kontrolerių — yra pagrindinė reikalinga tikrų NestJS programų kurimo žinia.
Kritiškai svarbu suprasti migracijų-o-ne-sinchronizavimo principą (niekada nesinchronizuoti schemos automatiškai gamyboje, kur tai gali sunaikinti duomenis, bet vietoj to naudoti versionuotas migracijas) — tai yra svarbi gamybos saugumo praktika.
Tai yra kasdienė, privaloma žinia, nes duomenų išlaikymas yra atsarginės plėtros centre ir ORM integravimas yra tai, kaip NestJS programos iš tikrųjų saugo ir nuskaito savo duomenis.