{"canonical_url":"https://engineer.company/es/glossary/migration/","content_markdown":"# Migración\n\n## Qué es\n\nUna migración es el traslado planificado de algo que ya se utiliza a una versión\no plataforma nueva, realizado por pasos y con la retirada de la anterior al\nfinal. Puede trasladarse una carga de trabajo completa, una aplicación, un\nconjunto de datos o la estructura que los almacena. Lo que distingue una\nmigración de una reconstrucción es que el sistema sigue utilizándose durante el\ntraslado: sus usuarios, registros e integraciones lo acompañan, y la versión\nanterior continúa funcionando hasta que la nueva toma el relevo.\n\nEn ingeniería se usa la palabra a dos escalas, a menudo sin aclarar cuál.\n\nA gran escala, se trata de pasar a otra plataforma o a una nueva versión\nprincipal. Cloud Adoption Framework de Microsoft divide el traslado de cargas de\ntrabajo a Azure, desde servidores locales o desde otra nube, en cinco pasos:\nplanificar, preparar las cargas, ejecutar, optimizar y retirar el origen. Los\nclientes de Esri trasladan sus mapas y datos de ArcMap a ArcGIS Pro. Una\naplicación Next.js pasa de Pages Router a App Router, y `getServerSideProps` deja paso a la\nobtención de datos dentro de Server Components. Un clúster PostgreSQL pasa a una\nnueva versión principal, que a menudo cambia la disposición de las tablas del\nsistema; los datos se trasladan con `pg_upgrade` o mediante un volcado y una\nrestauración.\n\nA pequeña escala, una migración es un cambio versionado de la estructura de una\nbase de datos, conservado como archivo en el repositorio y aplicado por una\nherramienta en un orden fijo. Django describe sus migraciones como un sistema de\ncontrol de versiones para el esquema de la base de datos: cada archivo registra\nun cambio en los modelos, se incorpora al historial junto con el código y se\nejecuta en la misma secuencia en el portátil de desarrollo, en el entorno de\npruebas previo a producción y en producción. GitLab distribuye migraciones en\nsegundo plano por lotes que reescriben tablas grandes, un lote cada vez, después\nde una actualización; por ejemplo, ampliar columnas de enteros a `bigint` antes de\nque se desborden. También entra en esta categoría una migración de datos: cambia\nfilas en lugar de columnas, como rellenar un campo nuevo a partir de dos\nantiguos.\n\nSon una misma idea a dos escalas. Ambas tienen un estado inicial conocido, una\nsecuencia ordenada de pasos, un destino y una forma de volver atrás si falla\nalgún paso. El traslado de plataforma suele incluir migraciones de esquema; una\nlarga sucesión de estas constituye, con los años, una plataforma que se\ntransforma pieza a pieza mientras sus usuarios siguen utilizándola.\n\n## Por qué importa\n\nEl software sobrevive a aquello sobre lo que se construyó. Se renegocian\ncontratos de nube, los marcos de trabajo cambian su modelo y los proveedores\nretiran productos. Un sistema que se conserva una década se migrará varias veces\ndurante ella: la capacidad del equipo para migrar acaba importando más que su\nacierto al elegir la primera plataforma.\n\n1. **El coste se concentra en el estado dividido.** Mientras una parte del\n   sistema se ejecuta en la plataforma antigua y otra en la nueva, hay que\n   operar, monitorizar y mantener coherentes ambas. Cloud Adoption Framework\n   indica que se acorte ese periodo y que los componentes directamente\n   dependientes entre sí se trasladen en la misma oleada.\n2. **Una base de datos no puede volver a desplegarse como el código.** El código\n   puede reconstruirse y sustituirse; las filas de producción, no. Las\n   migraciones de esquema convierten un cambio de la estructura en uso en un\n   archivo revisable, comprobable contra una copia, aplicable en orden y, para\n   la mayoría de los cambios, reversible. La alternativa es un esquema de\n   producción que sea lo que dejó la última persona con acceso a la consola.\n3. **Un traslado planificado puede deshacerse.** Cloud Adoption Framework pide\n   definir criterios y procedimientos de reversión antes de iniciar cualquier\n   migración, probar la reversión y establecer puntos de decisión para continuar\n   o detenerse durante el recorrido.\n\nLas contrapartidas se concentran en el cambio definitivo. Cloud Adoption\nFramework distingue entre migraciones con interrupción y con interrupción casi\nnula: en estas últimas, los datos se replican continuamente y el cambio se\nrealiza al final. Para una versión principal de PostgreSQL, `pg_upgrade` acorta ese\ncambio: reutiliza los archivos de datos existentes y evita el volcado y la\nrestauración que suele exigir una actualización de ese tipo. En modo `--link`, que no\ncopia archivos, resulta aún mucho más rápido.\n\n## Cómo se aplica en la práctica\n\nTres proyectos de este sitio muestran el término a tres escalas, desde una\nplataforma completa hasta el orden de los archivos de un repositorio.\n\nUna migración consistió en abandonar un proveedor de nube. La configuración AWS\nde un cliente tenía recursos sobredimensionados y el trabajo comenzó por revisar\nqué se utilizaba realmente: se eliminaron servicios innecesarios y se ajustó la\ncapacidad restante. Después, las cargas de trabajo [salieron de AWS](/es/portfolio/a-tenth-of-the-cloud-bill-and-nothing-lost/). El registro del encargo\nrespalda esos cambios de infraestructura. Eliminar servicios sin uso antes del\ntraslado redujo lo que había que transportar; no demuestra una proporción de\ncostes entre configuraciones equivalentes, un resultado de productividad ni una\nmigración sin interrupciones.\n\nLa segunda fue un cambio de motor con un diseño nuevo como destino. La base de\ndatos de una aplicación cartográfica pasó de MSSQL a PostgreSQL con la extensión\nPostGIS; el destino no era una copia de la estructura anterior. [El nuevo esquema se diseñó para datos espaciales](/es/portfolio/improved-gis-map-performance-10x-on-postgresql/), con índices\nGiST y SP-GiST y restricciones estrictas de claves foráneas y de comprobación\nque aplican reglas de validación a las coordenadas espaciales. Más de 50\nmillones de registros espaciales llegaron mediante flujos de procesamiento ETL\nque los transformaron a EPSG:4326. Adoptar un diseño nuevo permite expresar las\nreglas de los datos en el propio esquema. La página informa de una mejora de 10\nveces en el rendimiento de las consultas espaciales y de una reducción del 65 %\nen la carga de CPU del backend.\n\nLa tercera corresponde a la pequeña escala, mantenida durante años. El esquema\nde una plataforma es la suma de [1.022 migraciones, numeradas de 036 a 1102](/es/portfolio/1022-migrations-behind-a-schema-drift-gate/); la página califica de poco vistosa e\ninnegociable la disciplina que mantiene su orden. El historial del repositorio\ndescribe la producción y solo sigue siendo cierto mientras cualquier base de\ndatos, desde una copia nueva de desarrollo hasta una restauración, pueda\nreconstruirse reproduciéndolo desde el primer archivo hasta el último.\n\n## Dónde surgen los problemas\n\nLa planificación se centra en el cambio definitivo, pero los problemas suelen\nacumularse en las semanas que lo rodean, con cuatro formas reconocibles.\n\n**Dos sistemas conviven más tiempo del previsto.** El traslado se atasca a medio\ncamino, quedan las piezas difíciles y el equipo mantiene ambas plataformas\ndurante meses. Los usuarios notan la separación: la guía de Next.js indica que\npasar entre una página de Pages Router y otra de App Router implica una\nnavegación completa y que `next/link` no precarga entre ambos. Mantenga pequeñas las\noleadas y reduzca el coste de cada paso siguiente. Una interfaz de este\nportafolio va trasladando sus páginas a [una factoría compartida que carga cada página en un solo viaje de ida y vuelta](/es/portfolio/built-the-next-js-16-frontend-ssr-ssg-and-csr/); así, cada página convertida hereda\nese comportamiento.\n\n**Un cambio definitivo sin vuelta atrás.** Algunos pasos alteran tanto el origen\ncomo el destino. Con `pg_upgrade --link`, una vez iniciado el clúster nuevo, este habrá escrito\nen archivos compartidos con el anterior, que entonces deberá restaurarse desde\nuna copia de seguridad. Esri advierte de que un conjunto de datos actualizado\npara ArcGIS Pro puede dejar de ser utilizable en ArcMap e indica que se copie\nprimero. En Django, una operación `RunSQL` sin SQL de reversión provoca `IrreversibleError` en cuanto\nalguien migra hacia atrás. Defina los criterios de reversión antes del primer\npaso, ensaye la vuelta y conviértala en una comprobación: un repositorio de este\nportafolio ejecuta un motor de controles cuyos validadores incluyen [una comprobación de que una migración puede revertirse](/es/portfolio/built-a-268-check-guard-engine-for-the-repo/).\n\n**Se modifica una migración ya ejecutada.** Las herramientas registran qué\narchivos se han aplicado y después los omiten. Si cambia un archivo que ya llegó\na producción, esta conserva la versión antigua y cada base nueva recibe la\nnueva: dos esquemas bajo un solo historial. No modifique las migraciones\naplicadas; corríjalas con otra nueva. Un proceso de construcción que vuelve a aplicar el historial a una base de\ndatos vacía y compara el resultado con una copia migrada detecta la divergencia.\n\n**La base de datos actualizada va lenta el primer día.** `pg_upgrade` traslada la mayoría\nde las estadísticas del planificador, pero no todas; este hace estimaciones\nsobre el resto hasta que se reconstruyen. Su modo `--check` no cambia nada y puede\nejecutarse mientras el servidor anterior sigue atendiendo solicitudes: úselo\nprimero y reconstruya las estadísticas ausentes inmediatamente después de la\nactualización, antes de recopilar las restantes:\n\n```sh\npg_upgrade --check -b \"$OLD/bin\" -B \"$NEW/bin\" -d \"$OLD/data\" -D \"$NEW/data\"\npg_upgrade -b \"$OLD/bin\" -B \"$NEW/bin\" -d \"$OLD/data\" -D \"$NEW/data\"\nvacuumdb --all --analyze-in-stages --missing-stats-only\nvacuumdb --all --analyze-only\n```\n\n## Lecturas adicionales\n\n- [Planifique su migración](https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/migrate/) — el método de Microsoft para trasladar cargas a Azure: oleadas, opciones\n  de cambio definitivo y planificación de la reversión.\n- [Migraciones](https://docs.djangoproject.com/en/stable/topics/migrations/) — la guía de Django sobre cambios de esquema versionados, su reversión y\n  las migraciones de datos.\n- [pg_upgrade](https://www.postgresql.org/docs/current/pgupgrade.html) — la herramienta de actualización de PostgreSQL, con el modo de\n  comprobación, el de enlaces, la vuelta atrás y los pasos posteriores para las\n  estadísticas.\n- [Cómo migrar de Pages a App Router](https://nextjs.org/docs/app/guides/migrating/app-router-migration) — trasladar una aplicación Next.js al nuevo enrutador, página por página.\n- [Migrar trabajo existente](https://doc.esri.com/en/arcgis-pro/latest/get-started/migrate-existing-work.html) — qué se conserva de ArcMap a ArcGIS Pro, qué debe convertirse y de qué\n  conviene hacer copia antes.\n- [Comprobar las migraciones antes de actualizar](https://docs.gitlab.com/update/background_migrations/) — cómo las migraciones en segundo plano de GitLab reescriben tablas\n  grandes por lotes tras una actualización y cómo comprobar que han terminado.\n\n\u003chttps://engineer.company/es/glossary/migration/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Una migración traslada un sistema en uso o cambia su esquema por pasos. La convivencia, la reversión y el orden de los archivos deciden cómo sale.","formats":{"gemtext":"https://engineer.company/es/glossary/migration/index.gmi","gopher":"https://engineer.company/es/glossary/migration/gophermap","html":"https://engineer.company/es/glossary/migration/","json":"https://engineer.company/es/glossary/migration/index.json","markdown":"https://engineer.company/es/glossary/migration/index.md","pdf":"https://engineer.company/es/glossary/migration/index.pdf"},"kind":"page","language":"es","title":"¿Qué es una migración?","url":"https://engineer.company/es/glossary/migration/","version":1}