# Migración

## Qué es

Una migración es el traslado planificado de algo que ya se utiliza a una versión o plataforma nueva, realizado por pasos y con la retirada de la anterior al final. Puede trasladarse una carga de trabajo completa, una aplicación, un conjunto de datos o la estructura que los almacena. Lo que distingue una migración de una reconstrucción es que el sistema sigue utilizándose durante el traslado: sus usuarios, registros e integraciones lo acompañan, y la versión anterior continúa funcionando hasta que la nueva toma el relevo.

En ingeniería se usa la palabra a dos escalas, a menudo sin aclarar cuál.

A gran escala, se trata de pasar a otra plataforma o a una nueva versión principal. Cloud Adoption Framework de Microsoft divide el traslado de cargas de trabajo a Azure, desde servidores locales o desde otra nube, en cinco pasos: planificar, preparar las cargas, ejecutar, optimizar y retirar el origen. Los clientes de Esri trasladan sus mapas y datos de ArcMap a ArcGIS Pro. Una aplicación Next.js pasa de Pages Router a App Router, y `getServerSideProps` deja paso a la obtención de datos dentro de Server Components. Un clúster PostgreSQL pasa a una nueva versión principal, que a menudo cambia la disposición de las tablas del sistema; los datos se trasladan con `pg_upgrade` o mediante un volcado y una restauración.

A pequeña escala, una migración es un cambio versionado de la estructura de una base de datos, conservado como archivo en el repositorio y aplicado por una herramienta en un orden fijo. Django describe sus migraciones como un sistema de control de versiones para el esquema de la base de datos: cada archivo registra un cambio en los modelos, se incorpora al historial junto con el código y se ejecuta en la misma secuencia en el portátil de desarrollo, en el entorno de pruebas previo a producción y en producción. GitLab distribuye migraciones en segundo plano por lotes que reescriben tablas grandes, un lote cada vez, después de una actualización; por ejemplo, ampliar columnas de enteros a `bigint` antes de que se desborden. También entra en esta categoría una migración de datos: cambia filas en lugar de columnas, como rellenar un campo nuevo a partir de dos antiguos.

Son una misma idea a dos escalas. Ambas tienen un estado inicial conocido, una secuencia ordenada de pasos, un destino y una forma de volver atrás si falla algún paso. El traslado de plataforma suele incluir migraciones de esquema; una larga sucesión de estas constituye, con los años, una plataforma que se transforma pieza a pieza mientras sus usuarios siguen utilizándola.

## Por qué importa

El software sobrevive a aquello sobre lo que se construyó. Se renegocian contratos de nube, los marcos de trabajo cambian su modelo y los proveedores retiran productos. Un sistema que se conserva una década se migrará varias veces durante ella: la capacidad del equipo para migrar acaba importando más que su acierto al elegir la primera plataforma.

1. El coste se concentra en el estado dividido. Mientras una parte del sistema se ejecuta en la plataforma antigua y otra en la nueva, hay que operar, monitorizar y mantener coherentes ambas. Cloud Adoption Framework indica que se acorte ese periodo y que los componentes directamente dependientes entre sí se trasladen en la misma oleada.
2. Una base de datos no puede volver a desplegarse como el código. El código puede reconstruirse y sustituirse; las filas de producción, no. Las migraciones de esquema convierten un cambio de la estructura en uso en un archivo revisable, comprobable contra una copia, aplicable en orden y, para la mayoría de los cambios, reversible. La alternativa es un esquema de producción que sea lo que dejó la última persona con acceso a la consola.
3. Un traslado planificado puede deshacerse. Cloud Adoption Framework pide definir criterios y procedimientos de reversión antes de iniciar cualquier migración, probar la reversión y establecer puntos de decisión para continuar o detenerse durante el recorrido.

Las contrapartidas se concentran en el cambio definitivo. Cloud Adoption Framework distingue entre migraciones con interrupción y con interrupción casi nula: en estas últimas, los datos se replican continuamente y el cambio se realiza al final. Para una versión principal de PostgreSQL, `pg_upgrade` acorta ese cambio: reutiliza los archivos de datos existentes y evita el volcado y la restauración que suele exigir una actualización de ese tipo. En modo `--link`, que no copia archivos, resulta aún mucho más rápido.

## Cómo se aplica en la práctica

Tres proyectos de este sitio muestran el término a tres escalas, desde una plataforma completa hasta el orden de los archivos de un repositorio.

Una migración consistió en abandonar un proveedor de nube. La configuración AWS de un cliente tenía recursos sobredimensionados y el trabajo comenzó por revisar qué se utilizaba realmente: se eliminaron servicios innecesarios y se ajustó la capacidad restante. Después, las cargas de trabajo salieron de AWS. El registro del encargo respalda esos cambios de infraestructura. Eliminar servicios sin uso antes del traslado redujo lo que había que transportar; no demuestra una proporción de costes entre configuraciones equivalentes, un resultado de productividad ni una migración sin interrupciones.

La segunda fue un cambio de motor con un diseño nuevo como destino. La base de datos de una aplicación cartográfica pasó de MSSQL a PostgreSQL con la extensión PostGIS; el destino no era una copia de la estructura anterior. El nuevo esquema se diseñó para datos espaciales, con índices GiST y SP-GiST y restricciones estrictas de claves foráneas y de comprobación que aplican reglas de validación a las coordenadas espaciales. Más de 50 millones de registros espaciales llegaron mediante flujos de procesamiento ETL que los transformaron a EPSG:4326. Adoptar un diseño nuevo permite expresar las reglas de los datos en el propio esquema. La página informa de una mejora de 10 veces en el rendimiento de las consultas espaciales y de una reducción del 65 % en la carga de CPU del backend.

La tercera corresponde a la pequeña escala, mantenida durante años. El esquema de una plataforma es la suma de 1.022 migraciones, numeradas de 036 a 1102; la página califica de poco vistosa e innegociable la disciplina que mantiene su orden. El historial del repositorio describe la producción y solo sigue siendo cierto mientras cualquier base de datos, desde una copia nueva de desarrollo hasta una restauración, pueda reconstruirse reproduciéndolo desde el primer archivo hasta el último.

## Dónde surgen los problemas

La planificación se centra en el cambio definitivo, pero los problemas suelen acumularse en las semanas que lo rodean, con cuatro formas reconocibles.

Dos sistemas conviven más tiempo del previsto. El traslado se atasca a medio camino, quedan las piezas difíciles y el equipo mantiene ambas plataformas durante meses. Los usuarios notan la separación: la guía de Next.js indica que pasar entre una página de Pages Router y otra de App Router implica una navegación completa y que `next/link` no precarga entre ambos. Mantenga pequeñas las oleadas y reduzca el coste de cada paso siguiente. Una interfaz de este portafolio va trasladando sus páginas a una factoría compartida que carga cada página en un solo viaje de ida y vuelta; así, cada página convertida hereda ese comportamiento.

Un cambio definitivo sin vuelta atrás. Algunos pasos alteran tanto el origen como el destino. Con `pg_upgrade --link`, una vez iniciado el clúster nuevo, este habrá escrito en archivos compartidos con el anterior, que entonces deberá restaurarse desde una copia de seguridad. Esri advierte de que un conjunto de datos actualizado para ArcGIS Pro puede dejar de ser utilizable en ArcMap e indica que se copie primero. En Django, una operación `RunSQL` sin SQL de reversión provoca `IrreversibleError` en cuanto alguien migra hacia atrás. Defina los criterios de reversión antes del primer paso, ensaye la vuelta y conviértala en una comprobación: un repositorio de este portafolio ejecuta un motor de controles cuyos validadores incluyen una comprobación de que una migración puede revertirse.

Se modifica una migración ya ejecutada. Las herramientas registran qué archivos se han aplicado y después los omiten. Si cambia un archivo que ya llegó a producción, esta conserva la versión antigua y cada base nueva recibe la nueva: dos esquemas bajo un solo historial. No modifique las migraciones aplicadas; corríjalas con otra nueva. Un proceso de construcción que vuelve a aplicar el historial a una base de datos vacía y compara el resultado con una copia migrada detecta la divergencia.

La base de datos actualizada va lenta el primer día. `pg_upgrade` traslada la mayoría de las estadísticas del planificador, pero no todas; este hace estimaciones sobre el resto hasta que se reconstruyen. Su modo `--check` no cambia nada y puede ejecutarse mientras el servidor anterior sigue atendiendo solicitudes: úselo primero y reconstruya las estadísticas ausentes inmediatamente después de la actualización, antes de recopilar las restantes:

```sh
pg_upgrade --check -b "$OLD/bin" -B "$NEW/bin" -d "$OLD/data" -D "$NEW/data"
pg_upgrade -b "$OLD/bin" -B "$NEW/bin" -d "$OLD/data" -D "$NEW/data"
vacuumdb --all --analyze-in-stages --missing-stats-only
vacuumdb --all --analyze-only
```

## Lecturas adicionales
* Planifique su migración — el método de Microsoft para trasladar cargas a Azure: oleadas, opciones de cambio definitivo y planificación de la reversión.
* Migraciones — la guía de Django sobre cambios de esquema versionados, su reversión y las migraciones de datos.
* pg_upgrade — la herramienta de actualización de PostgreSQL, con el modo de comprobación, el de enlaces, la vuelta atrás y los pasos posteriores para las estadísticas.
* Cómo migrar de Pages a App Router — trasladar una aplicación Next.js al nuevo enrutador, página por página.
* Migrar trabajo existente — qué se conserva de ArcMap a ArcGIS Pro, qué debe convertirse y de qué conviene hacer copia antes.
* Comprobar las migraciones antes de actualizar — cómo las migraciones en segundo plano de GitLab reescriben tablas grandes por lotes tras una actualización y cómo comprobar que han terminado.

=> /es/portfolio/a-tenth-of-the-cloud-bill-and-nothing-lost/ salieron de AWS
=> /es/portfolio/improved-gis-map-performance-10x-on-postgresql/ El nuevo esquema se diseñó para datos espaciales
=> /es/portfolio/1022-migrations-behind-a-schema-drift-gate/ 1.022 migraciones, numeradas de 036 a 1102
=> /es/portfolio/built-the-next-js-16-frontend-ssr-ssg-and-csr/ una factoría compartida que carga cada página en un solo viaje de ida y vuelta
=> /es/portfolio/built-a-268-check-guard-engine-for-the-repo/ una comprobación de que una migración puede revertirse
=> https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/migrate/ Planifique su migración
=> https://docs.djangoproject.com/en/stable/topics/migrations/ Migraciones
=> https://www.postgresql.org/docs/current/pgupgrade.html pg_upgrade
=> https://nextjs.org/docs/app/guides/migrating/app-router-migration Cómo migrar de Pages a App Router
=> https://doc.esri.com/en/arcgis-pro/latest/get-started/migrate-existing-work.html Migrar trabajo existente
=> https://docs.gitlab.com/update/background_migrations/ Comprobar las migraciones antes de actualizar

=> https://engineer.company/es/glossary/migration/ Esta página en la web
