NestJS integra bases de datos de forma limpia a través de ORMs — más comúnmente TypeORM (integración oficial @nestjs/typeorm) y Prisma (un ORM moderno y type-safe utilizado a través de un servicio personalizado). Ambos se ajustan naturalmente a la estructura module/provider/DI de 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 utiliza clases @Entity (mapeadas a tablas) y Repositorys inyectables para consultas — se ajustan naturalmente al modelo DI de NestJS a través de @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 genera un cliente completamente type-safe a partir de un archivo de esquema; lo envuelve en un PrismaService inyectable y lo utiliza en sus servicios.
⚠️ 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
La integración de base de datos es esencial — casi todo back-end persiste datos, y entender cómo conectar una base de datos a NestJS de la forma idiomática es conocimiento práctico fundamental.
Ambos ORMs principales se ajustan limpiamente a la arquitectura de NestJS: TypeORM a través del módulo oficial @nestjs/typeorm (configurando conexiones, definiendo clases @Entity, inyectando Repositorys a través de DI) y Prisma a través de un PrismaService inyectable envuelto (que proporciona una seguridad de tipos excelente).
Saber cómo configurar la conexión, definir modelos e inyectar la capa de acceso a datos en servicios — manteniendo la lógica de la base de datos en servicios, separada de los controladores — es fundamental para construir aplicaciones NestJS reales.
Críticamente, entender el principio de migraciones-sobre-sincronización (nunca sincronizar automáticamente el esquema en producción, donde podría destruir datos, sino utilizar migraciones controladas por versión) es una práctica importante de seguridad en producción.
Este es material de uso diario y que debe conocer, ya que la persistencia de datos es central para el desarrollo back-end y la integración de ORM es cómo las aplicaciones NestJS realmente almacenan y recuperan sus datos.