NestJS integroi tietokantoja puhtaasti ORM:ien kautta — yleisimmin TypeORM (virallinen @nestjs/typeorm integraatio) ja Prisma (moderni, typpiturvallinen ORM, jota käytetään mukautetun palvelun kautta). Molemmat sopivat luonnollisesti NestJS:n moduuli/tarjoaja/DI rakenteeseen.
({
: [
.({
: ,
: 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 käyttää @Entity luokkia (taulukoihin kartoitettuja) ja injektoitavia Repositoryja kyselyihin — sopivat luonnollisesti NestJS:n DI-malliin @InjectRepository kautta.
// 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 generoi täysin typpiturvallisen asiakkaan skeemitiedostosta; käärit sen injektoitavaksi PrismaService:ksi ja käytät sitä palveluissasi.
⚠️ 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
Tietokannan integraatio on välttämätöntä — lähes jokainen tausta-alusta säilyttää tietoja, ja ymmärtäminen siitä, kuinka yhdistää tietokanta NestJS:ään idiomattisella tavalla, on keskeinen käytännön tieto.
Molemmat pääosin ORM:it sopivat puhtaasti NestJS:n arkkitehtuuriin: TypeORM virallisen @nestjs/typeorm moduulin kautta (yhteyksien konfigurointi, @Entity luokkien määritys, Repositoryjen injektoiminen DI:n kautta) ja Prisma käärityn injektoitavan PrismaService:n kautta (joka tarjoaa erinomaisen typpiturvallisen).
Tietäminen siitä, kuinka yhteys asetetaan, mallit määritetään ja data-access-kerros injektoidaan palveluihin — pitämällä tietokantalogiikka palveluissa erillään kontrolleista — on olennaista todellisten NestJS-sovellusten rakentamiselle.
Kritiikin kannalta oleellista on migraatiot-synkronoinnin-sijaan periaatteen ymmärtäminen (ei koskaan automaattista skeeman synkronointia tuotannossa, missä se voisi turmella tietoja, vaan versio-ohjattuja migraatioita käyttäen) on tärkeä tuotantoturvallisuuskäytäntö.
Tämä on päivittäistä, täytyy-tietää materiaalia, koska datan pysyvyys on keskeistä tausta-alustan kehitykselle ja ORM-integraatio on se, kuinka NestJS-sovellukset todella tallentavat ja hakevat tietojaan.