Tema 11 · TypeORM & Entidades

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).
🚨 Regla de Oro en Producción: Jamás dejes 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>:

src/cursos/entities/curso.entity.ts
Solo lectura
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
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.