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.

hEsta página en la web	URL:https://engineer.company/es/glossary/migration/	engineer.company	70
