{"canonical_url":"https://engineer.company/uk/glossary/migration/","content_markdown":"# Міграція\n\n## Що це таке\n\nМіграція — це запланований перехід чогось, що вже працює, на нову версію або\nнову платформу. Він відбувається кроками, а наприкінці старе виводять з\nексплуатації. Переносити можна ціле робоче навантаження, застосунок, масив даних\nабо структуру, в якій ці дані зберігаються. Від перебудови з нуля міграцію\nвідрізняє те, що система під час переходу лишається в роботі: користувачі,\nзаписи й інтеграції переходять разом із нею, а стара версія працює, доки нова не\nперебере все на себе.\n\nІнженери вживають це слово для робіт двох масштабів і рідко уточнюють, про який\nідеться.\n\nУ великому масштабі це перехід на нову платформу або нову мажорну версію.\nMicrosoft Cloud Adoption Framework описує перенесення робочих навантажень в\nAzure — із власних серверів або з іншої хмари — як п'ять кроків: спланувати,\nпідготувати навантаження, виконати, оптимізувати й вивести з експлуатації\nджерело. Клієнти Esri переносять свої карти й дані з ArcMap до ArcGIS Pro.\nЗастосунок на Next.js переходить із Pages Router на App Router, де\n`getServerSideProps` поступається місцем отриманню даних усередині Server\nComponents. Кластер PostgreSQL переходить на нову мажорну версію, яка часто\nзмінює будову системних таблиць, тож дані доводиться переносити за допомогою\n`pg_upgrade` або через дамп і відновлення.\n\nУ малому масштабі міграція — це одна версіонована зміна структури бази даних,\nяка зберігається як файл у репозиторії й застосовується інструментом у\nфіксованому порядку. Django називає свої міграції системою контролю версій для\nсхеми бази даних: кожен файл описує зміну моделей, потрапляє в коміт разом із\nкодом і виконується в тому самому порядку на машині розробника, на staging і в\nпродакшні. GitLab постачає пакетні фонові міграції, які після оновлення\nпереписують великі таблиці порціями, наприклад перетворюють цілочисельні стовпці\nна `bigint`, перш ніж значення в них переповняться. Сюди ж належить міграція\nданих: вона змінює рядки, а не стовпці, — скажімо, заповнює нове поле на основі\nдвох старих.\n\nЦе одна ідея у двох масштабах. В обох випадках є відомий початковий стан,\nупорядкована послідовність кроків, ціль і шлях назад, якщо якийсь крок піде не\nтак. Перехід на нову платформу зазвичай містить міграції схеми, а довгий ряд\nміграцій схеми з роками стає платформою, що змінюється шматок за шматком під\nтими, хто нею користується.\n\n## Чому це важливо\n\nПрограмне забезпечення живе довше, ніж те, на чому його збудовано. Хмарні\nконтракти переукладають, фреймворки змінюють модель, постачальники знімають\nпродукти з підтримки. Систему, яку тримають десять років, за ці десять\nроків мігрують кілька разів, тож уміння команди мігрувати важить більше, ніж те,\nнаскільки вдало вона обрала першу платформу.\n\n1. **Витрати осідають у проміжному стані.** Поки частина системи працює на\n   старій платформі, а частина на новій, обидві треба експлуатувати, моніторити\n   й тримати узгодженими. Cloud Adoption Framework радить робити цей період\n   коротким і переносити компоненти, що напряму залежать один від одного, в\n   одній хвилі.\n2. **Базу даних не можна просто розгорнути заново.** Код можна зібрати знову й\n   замінити; рядки в продакшні — ні. Міграції схеми перетворюють зміну структури\n   робочої бази на файл, який можна віддати на рев'ю, перевірити на копії,\n   застосувати в заданому порядку й здебільшого відкотити. Альтернатива — схема\n   продакшну, яка має той вигляд, у якому її залишив останній, хто відкривав\n   консоль.\n3. **Запланований перехід можна скасувати.** Cloud Adoption Framework вимагає\n   встановити критерії та процедури відкату ще до початку будь-якої міграції,\n   перевірити відкат на ділі й передбачити контрольні точки go/no-go на шляху.\n\nКомпроміси зосереджені в моменті перемикання. Cloud Adoption Framework розрізняє\nміграцію з простоєм і міграцію майже без простою, коли дані безперервно\nреплікуються, а перемикання відбувається наприкінці. Для мажорної версії\nPostgreSQL `pg_upgrade` скорочує перемикання: він обходиться без дампу й\nвідновлення, яких зазвичай потребує таке оновлення, повторно використовуючи\nнаявні файли даних, а в режимі `--link`, що не копіює файлів, працює ще значно\nшвидше.\n\n## Як це виглядає на практиці\n\nТри проєкти на цьому сайті показують це поняття у трьох масштабах — від цілої\nплатформи до порядку файлів в одному репозиторії.\n\nОдна з міграцій полягала у відмові від хмарного провайдера. Конфігурація AWS у клієнта була надмірною, і робота почалася з перевірки того, що справді використовували: непотрібні сервіси прибрали, а потужність решти скоригували. Після цього навантаження [перенесли з AWS](/uk/portfolio/a-tenth-of-the-cloud-bill-and-nothing-lost/). Запис про роботу з клієнтом підтверджує ці інфраструктурні зміни. Скорочення невикористаних сервісів перед перенесенням означало менше обсягу для міграції; це не підтверджує співвідношення витрат за однакових умов, результату щодо продуктивності чи міграції без порушень роботи.\n\nДругий — зміна рушія бази даних з новим дизайном на іншому боці. База даних\nкартографічного застосунку переїхала з MSSQL на PostgreSQL з розширенням\nPostGIS, і метою була не копія старої структури.\n[Нову схему спроєктували для просторових даних](/uk/portfolio/improved-gis-map-performance-10x-on-postgresql/),\nз індексами GiST і SP-GiST та суворими обмеженнями зовнішніх ключів і\nперевірками, що забезпечують правила валідації просторових координат. Понад\n50 мільйонів просторових записів перейшли до неї через ETL-конвеєри, які\nпривели їх до EPSG:4326. Перехід на новий дизайн — нагода записати правила даних\nу саму схему. Сторінка повідомляє про зростання продуктивності просторових\nзапитів у 10 разів і про зниження навантаження на CPU бекенду на 65%.\n\nТретій — малий масштаб, який підтримують роками. Схема однієї платформи\nскладається з\n[1 022 міграцій з номерами від 036 до 1102](/uk/portfolio/1022-migrations-behind-a-schema-drift-gate/),\nа дисципліну їх упорядкування сторінка називає нудною й такою, що не підлягає\nобговоренню. Історія в репозиторії — це опис продакшну, і вона лишається\nправдивою, лише доки будь-яку базу даних — від щойно створеної на машині\nрозробника до відновленої з резервної копії — можна зібрати заново, відтворивши\nцю історію від першого файлу до останнього.\n\n## Де виникають проблеми\n\nПеремикання отримує всю увагу під час планування, а проблеми зазвичай збираються\nв тижні навколо нього, у чотирьох упізнаваних формах.\n\n**Дві системи працюють паралельно довше, ніж планували.** Перехід зупиняється на\nпівдорозі, лишаються найскладніші частини, і команда місяцями підтримує обидві\nплатформи. Користувачі відчувають шов: посібник Next.js зазначає, що перехід між\nсторінкою на Pages Router і сторінкою на App Router — це перехід із повним перезавантаженням сторінки і що\n`next/link` не виконує попереднього завантаження між ними. Варто тримати хвилі малими, а кожен\nнаступний крок — дешевим. Один фронтенд тут переводить свої сторінки на\n[спільну фабрику, що завантажує кожну сторінку за одне звернення](/uk/portfolio/built-the-next-js-16-frontend-ssr-ssg-and-csr/),\nтож кожна перенесена сторінка успадковує цю поведінку.\n\n**Перемикання без шляху назад.** Деякі кроки змінюють не лише ціль, а й джерело.\nЗ `pg_upgrade --link` новий кластер, щойно його запущено, уже записав у файли,\nспільні зі старим, і тоді старий кластер доведеться відновлювати з резервної\nкопії. Esri попереджає, що набір даних, оновлений для ArcGIS Pro, може стати\nнепридатним для ArcMap, і радить спершу зробити копію. У Django операція\n`RunSQL` без зворотного SQL викликає `IrreversibleError`, щойно хтось спробує\nмігрувати назад. Критерії відкату варто визначити до першого кроку, шлях назад —\nвідрепетирувати, а саму вимогу — перетворити на перевірку: один репозиторій тут\nмає рушій захисних перевірок, валідатори якого серед іншого контролюють,\n[що міграцію можна відкотити](/uk/portfolio/built-a-268-check-guard-engine-for-the-repo/).\n\n**Уже застосовану міграцію редагують.** Інструменти міграцій записують, які\nфайли вже застосовано, і далі їх пропускають. Якщо змінити файл після того, як\nвін потрапив у продакшн, продакшн зберігає стару версію, а кожна нова база даних\nотримує нову: дві схеми під однією історією. Застосовані міграції краще не\nчіпати, а виправляти новою; збірка, яка відтворює всю історію на порожній базі й\nпорівнює результат із мігрованою копією, ловить розбіжність.\n\n**Оновлена база даних повільна в перший день.** `pg_upgrade` переносить більшу\nчастину статистики планувальника, але не всю, і щодо решти планувальник діє\nнавмання, доки її не зібрано знову. Режим `--check` нічого не змінює й може\nпрацювати, поки старий сервер ще обслуговує запити, тож його запускають першим,\nа відсутню статистику відновлюють одразу після оновлення, перш ніж збирати\nрешту:\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## Що почитати далі\n\n- [Plan your migration](https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/migrate/)\n  — методологія Microsoft для перенесення робочих навантажень в Azure: хвилі,\n  варіанти перемикання й планування відкату.\n- [Migrations](https://docs.djangoproject.com/en/stable/topics/migrations/) —\n  посібник Django про версіоновані зміни схеми, їх відкат і міграції даних.\n- [pg_upgrade](https://www.postgresql.org/docs/current/pgupgrade.html) —\n  інструмент оновлення PostgreSQL: режим перевірки, режим link, повернення до\n  старого кластера й кроки зі статистикою після оновлення.\n- [How to migrate from Pages to the App Router](https://nextjs.org/docs/app/guides/migrating/app-router-migration)\n  — як перевести застосунок Next.js на новий маршрутизатор сторінка за\n  сторінкою.\n- [Migrate existing work](https://doc.esri.com/en/arcgis-pro/latest/get-started/migrate-existing-work.html)\n  — що переходить з ArcMap до ArcGIS Pro, що треба конвертувати і що варто\n  спершу скопіювати.\n- [Check migrations before upgrade](https://docs.gitlab.com/update/background_migrations/)\n  — як пакетні фонові міграції GitLab переписують великі таблиці після оновлення\n  і як переконатися, що вони завершилися.\n\n\u003chttps://engineer.company/uk/glossary/migration/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що таке міграція: від переїзду цілої платформи до однієї впорядкованої зміни схеми, чому обом потрібен шлях назад і чотири типові пастки під час переїзду.","formats":{"gemtext":"https://engineer.company/uk/glossary/migration/index.gmi","gopher":"https://engineer.company/uk/glossary/migration/gophermap","html":"https://engineer.company/uk/glossary/migration/","json":"https://engineer.company/uk/glossary/migration/index.json","markdown":"https://engineer.company/uk/glossary/migration/index.md","pdf":"https://engineer.company/uk/glossary/migration/index.pdf"},"kind":"page","language":"uk","title":"Що таке міграція?","url":"https://engineer.company/uk/glossary/migration/","version":1}