11. Integración con Bases de Datos Relacionales (MySQL / PostgreSQL) mediante TypeORM
Conecta NestJS con MySQL o PostgreSQL, modela tablas con decoradores @Entity() e inyecta repositorios con @InjectRepository().
El Patrón Repository con @nestjs/typeorm
TypeORM es uno de los ORMs más maduros de TypeScript y cuenta con integración oficial de primera clase en NestJS mediante el paquete @nestjs/typeorm. Aprovecha los decoradores de TypeScript (@Entity(), @Column(), @PrimaryGeneratedColumn()) para mapear clases directamente a tablas SQL en MySQL, MariaDB o PostgreSQL.
# Instalar integración TypeORM + driver MySQL2
npm i @nestjs/typeorm typeorm mysql2
Conexión Raíz vs Registro por Módulo
| Método | Dónde se declara | Propósito |
|---|---|---|
TypeOrmModule.forRootAsync() |
En AppModule |
Establece el pool de conexiones principal hacia MySQL/PostgreSQL inyectando ConfigService. |
TypeOrmModule.forFeature([Curso]) |
En CursosModule |
Habilita el repositorio de las entidades indicadas para que puedan inyectarse en ese módulo con @InjectRepository(Curso). |
synchronize: true en producción. Esa opción modifica o elimina columnas automáticamente al reiniciar el servidor y puede causar pérdida de datos; en producción usa siempre migraciones controladas.
⚡ Entidad TypeORM e Inyección de Repositorio en el Servicio
Definición de la tabla cursos con decoradores y operaciones CRUD asíncronas con Repository<Curso>:
import {
Entity,
PrimaryGeneratedColumn,
Column,
CreateDateColumn,
UpdateDateColumn,
Repository,
} from 'typeorm';
import { Injectable, NotFoundException } from '@nestjs/common';
import { InjectRepository } from '@nestjs/typeorm';
import { CrearCursoDto } from '../dto/crear-curso.dto';
@Entity('cursos')
export class Curso {
@PrimaryGeneratedColumn()
id: number;
@Column({ length: 150 })
titulo: string;
@Column({ unique: true, length: 160 })
slug: string;
@Column({ type: 'int', unsigned: true })
horas: number;
@Column({ name: 'precio_cop', type: 'int', unsigned: true })
precioCop: number;
@Column({ name: 'es_activo', default: true })
esActivo: boolean;
@CreateDateColumn({ name: 'created_at' })
createdAt: Date;
@UpdateDateColumn({ name: 'updated_at' })
updatedAt: Date;
}
@Injectable()
export class CursosOrmService {
constructor(
@InjectRepository(Curso)
private readonly cursoRepo: Repository<Curso>,
) {}
async listarActivos(): Promise<Curso[]> {
return this.cursoRepo.find({
where: { esActivo: true },
order: { id: 'DESC' },
});
}
async crear(dto: CrearCursoDto, slug: string): Promise<Curso> {
const nuevo = this.cursoRepo.create({ ...dto, slug });
return this.cursoRepo.save(nuevo);
}
async obtenerPorId(id: number): Promise<Curso> {
const curso = await this.cursoRepo.findOneBy({ id });
if (!curso) throw new NotFoundException(`Curso #${id} no encontrado`);
return curso;
}
}
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Por qué es peligroso dejar activa la opción synchronize: true en la configuración de TypeOrmModule cuando despliegas a un servidor de producción?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar NestJS Framework Profesional y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.