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

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:006:26

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

Curso de NestJS: Persistencia de Datos con TypeORM

Clase 16 de 36

Clase 16 / 36

Recursos

¿Cómo ejecutar una migración correctamente?

Generar una migración en un proyecto es solo el primer paso. Para aplicar estos cambios a nuestra base de datos, debemos ejecutar la migración y llevar un control de cuáles ya han sido aplicadas. Este proceso es esencial para mantener la integridad de nuestra estructura de datos y asegurar que todos los cambios se incorporen de forma eficiente.

¿Cómo configurar npm para ejecutar migraciones?

Para gestionar efectivamente las migraciones en un proyecto usando Time1M y npm, primero debemos añadir nuevas tareas en nuestro archivo package.json. Estas tareas nos permitirán correr migraciones y monitorear cuáles se han ejecutado.

Ejemplo de comandos a añadir en package.json:

"scripts": {
  "migrations:run": "npx time1m run",
  "migrations:show": "npx time1m show",
  "migrations:drop": "npx time1m drop"
}

¿Qué tareas se deben agregar?

Run (ejectuar migración): Para aplicar una nueva migración y asegurarse de que está registrada en el control de migraciones.
Show (mostrar migraciones): Para listar las migraciones que se han ejecutado hasta el momento.
Drop (borrar datos): Un comando delicado que elimina todas las tablas y datos; debe usarse con precaución.

Para ejecutar la migración simplemente debemos correr el comando desde la terminal:

npm run migrations:run

¿Qué hacer si encuentras errores en la ejecución?

Como es común en la programación, puedes encontrar errores al intentar correr una migración. Si, al ejecutar el comando para correr migraciones, aparece un mensaje de error diciendo que la tabla ya existe, debemos revisar la configuración de nuestro proyecto.

Un posible ajuste es desactivar el modo síncrono si todavía está activado. Esto se hace ajustando la configuración para que el sincronismo se maneje a través de migraciones:

// Configuración del modo síncrono desactivado
sincronizar: false

Además, es posible que debamos usar herramientas adicionales, como pgAdmin, para borrar manualmente tablas existentes, permitiendo que la migración corra sin conflictos.

Usar pgAdmin para gestionar tablas

Al gestionar bases de datos, herramientas GUI como pgAdmin permiten una mayor visibilidad y control. Si necesitamos eliminar tablas previas manualmente, pgAdmin simplifica este proceso:

Abre el pgAdmin y localiza la tabla products.
Elimina la tabla si ya existe para evitar conflictos de duplicado.
Borra también la tabla migrations si así lo deseas para un nuevo comienzo limpio.

¿Cómo verificar migraciones exitosas?

Una vez que la migración se haya corrido sin errores podemos verificar que sus resultados sean correctos. Usando pgAdmin, podemos refrescar nuestras tablas y comprobar si los datos se han registrado correctamente:

Verifica que la tabla migrations está actualizada.
Asegúrate de que la nueva estructura y los datos de la tabla products coinciden con la especificación de la migración.

Finalmente, recuerda que cualquier cambio en los datos debe ser realizado de forma pausada y con control de versiones para mantener la integridad de la base de datos. Sigue explorando y experimentando con comandos adicionales que puedes aplicar consultando la documentación de Time1M. ¡Sigue adelante aprendiendo y perfeccionando tus habilidades en la gestión de bases de datos!

Walter Lensinas

Hace 5 años

Si le agregan el revert esta bueno experimentarlo, mas que nada para volver a atras los cambios en caso de que se haya detectado algun bug y tengas que salir a patchear la version que sacaste.

Agregas en el package.json

    "migrations:revert": "npm run typeorm -- migration:revert"

Este el output:

query: SELECT * FROM "information_schema"."tables" WHERE "table_schema" = current_schema() AND "table_name" = 'migrations'
query: SELECT * FROM "migrations" "migrations" ORDER BY "id" DESC
1 migrations are already loaded in the database.
init1621883836551 is the last executed migration. It was executed on Mon May 24 2021 16:17:16 GMT-0300 (Argentina Standard Time).
Now reverting it...
query: START TRANSACTION
query: DROP TABLE "user"
query: DROP TABLE "customer"
query: DROP TABLE "product"
query: DROP TABLE "category"
query: DROP TABLE "brand"
query: DELETE FROM "migrations" WHERE "timestamp" = $1 AND "name" = $2 -- PARAMETERS: [1621883836551,"init1621883836551"]
Migration init1621883836551 has been reverted successfully.
query: COMMIT

Walter Lensinas

Hace 5 años

en el caso del script del drop, se dropea el schema no la migracion, por lo que tendrian que cambiarlo. Borra todo dentro de la base.

"migrations:drop": "npm run typeorm -- schema:drop",

output

query: START TRANSACTION
query: SELECT 'DROP VIEW IF EXISTS "' || schemaname || '"."' || viewname || '" CASCADE;' as "query" FROM "pg_views" WHERE "schemaname" IN (current_schema()) AND "viewname" NOT IN ('geography_columns', 'geometry_columns', 'raster_columns', 'raster_overviews')
query: SELECT 'DROP TABLE IF EXISTS "' || schemaname || '"."' || tablename || '" CASCADE;' as "query" FROM "pg_tables" WHERE "schemaname" IN (current_schema()) AND "tablename" NOT IN ('spatial_ref_sys')
query: DROP TABLE IF EXISTS "public"."migrations" CASCADE;
query: DROP TABLE IF EXISTS "public"."brand" CASCADE;
query: DROP TABLE IF EXISTS "public"."category" CASCADE;
query: DROP TABLE IF EXISTS "public"."product" CASCADE;
query: DROP TABLE IF EXISTS "public"."customer" CASCADE;
query: DROP TABLE IF EXISTS "public"."user" CASCADE;
query: SELECT 'DROP TYPE IF EXISTS "' || n.nspname || '"."' || t.typname || '" CASCADE;' as "query" FROM "pg_type" "t" INNER JOIN "pg_enum" "e" ON "e"."enumtypid" = "t"."oid" INNER JOIN "pg_namespace" "n" ON "n"."oid" = "t"."typnamespace" WHERE "n"."nspname" IN (current_schema()) GROUP BY "n"."nspname", "t"."typname"
query: COMMIT
Database schema has been successfully dropped.

Y para volver a generar la base de datos, solo se tiene que ejecutar el run de la migracion.

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

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