Actualización de Migraciones en TimeWareM 0.3

Curso de NestJS: Persistencia de Datos con TypeORM

Contenido del curso

Introducción

Database

TypeORM

Migraciones

Relaciones

Consultas

Migración a NestJS 9 y TypeORM 0.3

Próximos pasos

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0020:13

Actualización de Migraciones en TimeWareM 0.3

Curso de NestJS: Persistencia de Datos con TypeORM

Clase 34 de 36

Clase 34 / 36

Recursos

Actualizar el sistema de migraciones es uno de los pasos más críticos al migrar de TypeORM 0.2 a TypeORM 0.3. Los cambios no solo afectan la forma en que se ejecutan los comandos, sino también cómo se configura la conexión a la base de datos. A continuación se explican los ajustes necesarios para que todo funcione correctamente en un proyecto con NestJS 9.

¿Por qué TypeORM 0.3 ya no lee variables de entorno ni ormconfig?

En versiones anteriores, TypeORM podía leer la configuración de conexión desde variables de entorno predefinidas o desde un archivo llamado ormconfig.json. Ambas opciones han sido deprecadas en la versión 0.3 [01:15]. Esto significa que si tu proyecto dependía de cualquiera de esas dos formas, necesitas un ajuste obligatorio.

El concepto central ahora es el DataSource. Se trata de una instancia donde defines explícitamente los datos de conexión: tipo de base de datos, URL, entidades, migraciones y más. TypeORM ya no adivinará de dónde obtener esos datos.

Es fundamental entender que existen dos conexiones diferentes [02:05]:

La conexión que usa tu API en producción para consultar y escribir datos.
La conexión que usa el sistema de migraciones desde la línea de comandos.

Cada una corre en un nivel distinto y requiere su propia configuración.

¿Cómo se crea el archivo DataSource para migraciones?

Dentro del módulo de database, se crea un archivo data-source.ts con la siguiente estructura [03:00]:

typescript import { DataSource } from 'typeorm';

export const appDataSource = new DataSource({ type: 'postgres', url: 'postgres://usuario:password@host:puerto/nombre_db', synchronize: false, logging: false, migrations: ['./src/database/migrations/.ts'], entities: ['./src/**/.entity.ts'], });

type: el motor de base de datos, en este caso postgres.
url: un string con toda la información de conexión en un solo lugar.
synchronize: se establece en false para evitar cambios automáticos en producción.
migrations y entities: rutas donde TypeORM encuentra los archivos correspondientes.

¿Qué cambió en los scripts del package.json?

El comando para invocar el CLI de TypeORM ahora utiliza un módulo especial llamado ESM (EcmaScript Modules) [05:22]. Además, se requiere pasar el parámetro -d para indicar la ubicación del DataSource:

"typeorm": "typeorm-ts-node-esm -d ./src/database/data-source.ts"

Otro cambio importante está en el comando generate. Antes se usaba -n seguido del nombre de la migración. Ahora se debe indicar la ruta completa donde se guardará el archivo [08:20]:

bash npm run migrations:generate -- ./src/database/migrations/change-limit-brand-name

TypeORM añade automáticamente un timestamp al nombre para mantener el orden de ejecución. Los comandos run, show y drop se mantienen prácticamente iguales.

¿Cómo leer variables de entorno desde el DataSource?

Dejar credenciales de conexión en texto plano dentro del código no es seguro. En la API de NestJS se utiliza @nestjs/config para leer el archivo .env, pero el sistema de migraciones no corre dentro de NestJS [10:45]. Por eso se necesita instalar el paquete dotenv:

bash npm install dotenv

Luego se importa y configura en el archivo data-source.ts [11:30]:

typescript import * as dotenv from 'dotenv'; import { DataSource } from 'typeorm';

dotenv.config();

export const appDataSource = new DataSource({ type: 'postgres', url: process.env.DATABASE_URL, synchronize: false, logging: false, migrations: ['./src/database/migrations/.ts'], entities: ['./src/**/.entity.ts'], });

Por defecto, dotenv.config() busca un archivo .env en la raíz del proyecto. Este archivo no se sube al repositorio porque está en el .gitignore, lo cual garantiza que las credenciales permanezcan seguras. Al desplegar en plataformas como AWS, Heroku o Digital Ocean, las variables de entorno se configuran directamente en el servicio [12:30].

¿Cómo verificar que el sistema de migraciones funciona?

Una vez configurado el DataSource, se pueden ejecutar los comandos habituales [06:50]:

npm run migrations:show muestra las migraciones pendientes y ejecutadas.
npm run migrations:run ejecuta las migraciones faltantes.
npm run migrations:drop elimina todas las migraciones aplicadas.

Las migraciones funcionan como un control de versiones para la base de datos [07:40]. En un sistema productivo no se borra la base de datos desde cero, sino que se aplican cambios de estructura de forma controlada y uniforme.

Con estos ajustes, el proyecto queda actualizado de NestJS 7 con TypeORM 0.2 a NestJS 9 con TypeORM 0.3, incluyendo un sistema de migraciones seguro y listo para producción. Si tienes dudas sobre la configuración o has encontrado diferencias en tu proyecto, comparte tu experiencia en los comentarios.

Andre Huaman Yovera

Hace 2 años

# Generación de Migraciones Simplificada con TypeORM

Para simplificar el proceso de generación de migraciones en un proyecto que utiliza TypeORM, hemos creado un archivo llamado migration-generator.ts. Este archivo permite especificar solo el nombre de la migración, y automáticamente coloca la migración en la ruta correcta (src/database/migrations/). Esto elimina la necesidad de escribir manualmente la ruta cada vez.

## 1. Código del migration-generator.ts

Crea un archivo llamado migration-generator.ts en la carpeta src/database/ con el siguiente contenido:

import { execSync } from "child_process";

// Obtiene los argumentos de la línea de comandos

const args = process.argv.slice(2);

// Verifica que se haya pasado un nombre

if (args.length === 0) {

console.error("Por favor, proporciona un nombre para la migración.");

process.exit(1);

}

const migrationName = args[0]; // Toma el primer argumento

// Comando para generar la migración usando TypeORM

const command = `npm run typeorm migration:generate src/database/migrations/${migrationName}`;

// Ejecuta el comando

try {

execSync(command, { stdio: "inherit" });

console.log(`Migración '${migrationName}' generada con éxito.`);

} catch (error) {

console.error("Error al generar la migración:", error);

process.exit(1);

}

## 2. Actualización del Script en package.json

Para usar este archivo, necesitas actualizar el script en tu archivo package.json. Abre package.json y modifica la sección de scripts de la siguiente manera:

"scripts": {

"typeorm": "typeorm-ts-node-commonjs -d src/database/database.data-source.ts",

"migration:generate": "ts-node src/database/migration-generator.ts",

// otros scripts

}

## 3. Uso

Ahora, para generar una migración, simplemente ejecuta el siguiente comando en tu terminal, pasando como argumento el nombre de tu migración:

npm run migration:generate NombreDeTuMigracion

Esto generará la migración en la carpeta src/database/migrations/ de forma automática, utilizando el nombre que especificaste.

## Beneficios

Este enfoque simplifica el proceso de generación de migraciones y reduce errores al no tener que especificar manualmente la ruta cada vez que desees crear una nueva migración. Solo necesitas concentrarte en dar un buen nombre a tu migración y dejar que el script se encargue del resto.

---

¡Listo! Ahora puedes generar migraciones de manera más eficiente y sin complicaciones.

Comentarios (18)18 comentarios

Axlin Miranda

Hace 3 años

Andrés Felipe Cuéllar Cataño

Jorge Luis Silva Medina

DUVIER JOSE MARTINEZ ALVAREZ

Vanessa Quiquia

Matias Acosta

Anthony Hurtado

Hace 4 años

Harold William Victoria Sandoval

Jose Joel Montes Utos

Brandon Lee Aguero Fernandez

José de Jesús Valera Durán

Hace 4 meses

Brayan Jeshua

Bryan Canon

Jose Manuel Moreno

Guillermo de Jesús Ramírez Bañuelos

Camilo Calderon

Jaume Parrot Altisent

Introducción

Conexiones a Bases de Datos con Time OEM y NetsGIS

Integración de Datos con Next.js y Time ORM en Proyectos E-commerce

Database

Instalación de Docker en Windows, macOS y Ubuntu

Configuración de Postgres en Docker Compose

Conexión a Postgres en Docker: Terminal y PgAdmin

Conexión de NestJS a Postgres con Node Postgres

Inyección de Dependencias en NETJS: Conexión a PostgreSQL

Conexión a Bases de Datos con Variables de Entorno en Node.js

TypeORM

Implementación de TypeORM con NestJS en Proyectos Node.js

Creación de Entidades en ORM para Tiendas Virtuales

Implementación del Patrón Repository en NestJS con TypeORM

Operaciones CRUD en ProductService usando TypeORM y Postgres

Cambio de Postgres a MySQL en Docker para CRUD de Productos

Migraciones

Configuración de Migraciones en Bases de Datos con TimeORM

Configuración y uso de migraciones con TimeORM y TypeScript

Ejecución y gestión de migraciones con Time1M en Node.js

Migraciones en bases de datos: agregar campos automáticamente

Relaciones

Relaciones 1 a 1 en Bases de Datos con TimeORM

Manipulación de Relaciones Uno a Uno en Controladores y Servicios

Relaciones Uno a Muchos en Bases de Datos con TypeORM

Gestión de Relaciones Uno a Muchos en Controladores de API

Relaciones Muchos a Muchos en Time1M: Creación y Manejo Práctico

Manipulación de Relaciones Muchos a Muchos en Controladores

Manipulación de Relaciones Muchos a Muchos con TimeORM en JavaScript

Relaciones Muchos a Muchos con Campos Agregados en TimeWareM

CRUD de órdenes de compra y gestión de ítems en NestJS

Consultas

Paginación de Productos con Limit y Offset en Controladores API

Filtrado de Precios con Rango Usando Between en Time Wareham

Indexación de Parámetros en Bases de Datos: Uso y Precauciones

Buenas prácticas de nombramiento en JavaScript y bases de datos

Serialización y Transformación de Datos en APIs con ClassTransformer

Migración a NestJS 9 y TypeORM 0.3

Actualización de dependencias en NEST y TimeWareM

Migración y ajustes en TimewareM 0.3: Cambios en métodos y servicios

Actualización de Migraciones en TimeWareM 0.3

Próximos pasos

Soluciones a referencias circulares en módulos NestJS

Persistencia de Datos con Time Ware M: Conexiones y Buenas Prácticas

Actualización de Migraciones en TimeWareM 0.3