Міграції схем баз даних без простою для високонавантажених застосунків: патерн Expand-and-Contract, тіньові колонки та воркери у Next.js 16
Виконання міграцій схем баз даних без простою у високонавантажених застосунках Next.js 16 із тисячами операцій запису на секунду: патерн Expand-and-Contract, подвійний запис через Server Actions, тіньові колонки та асинхронні бекфіл-воркери без блокування таблиць.
Міграції схем баз даних без простою для високонавантажених застосунків: патерн Expand-and-Contract, тіньові колонки та воркери у Next.js 16
У високонавантажених продакшн-системах, які обробляють тисячі операцій запису на секунду, виконання прямих міграцій структури бази даних на зразок ALTER TABLE users ADD COLUMN address_json JSONB NOT NULL неминуче призводить до відмови сервісу.
Навіть у сучасних рушіях PostgreSQL або MySQL Vitess зміна активної таблиці вимагає отримання ексклюзивного блокування метаданих (`AccessExclusiveLock`). Хоча додавання колонки без значення за замовчуванням може зайняти лічені мілісекунди, DDL-запит повинен дочекатися завершення всіх активних транзакцій читання. При цьому всі наступні запити читання та запису стають у чергу позаду DDL, що миттєво вичерпує пул з'єднань, викликає каскад помилок 504 Gateway Timeout та зупиняє оформлення замовлень.
Для забезпечення доступності 99.999% SLA провідні інженерні команди використовують патерн Expand-and-Contract (паралельний запуск). У цьому матеріалі ми детально розбираємо, як реалізувати безперервну еволюцію схем баз даних у Next.js 16 за допомогою подвійного запису через Server Actions, тіньових колонок, фонових воркерів бекфілу та канареєчного перемикання читання.
Матриця швидкого вибору архітектури: патерни міграції баз даних під навантаженням
| Стратегія міграції | Даунтайм і технічне вікно | Безпека даних і відкат | Ризик блокування таблиць | Інженерна складність |
|---|---|---|---|---|
| Прямий DDL (ALTER TABLE) | Вимагає зупинки сервісу (Хвилини або години) | Деструктивний (Миттєвий збій при невідповідності) | Катастрофічний (Каскад блокувань AccessExclusive) | Низька (Одна SQL-команда) |
| Копіювання тіньової таблиці (pt-online) | Нульовий даунтайм (Тригерний подвійний запис) | Висока надійність із автоперевіркою чексум | Помірний (Накладні витрати тригерів на майстрі) | Середня (Утиліти та права доступу) |
| Expand-and-Contract (Рекомендований) | Нульовий даунтайм (100% 24/7 доступність) | Мінімальний ризик (Миттєвий відкат фіча-прапорцем) | Нуль блокувань (Безпечні nullable колонки) | Висока (Вимагає 4-фазного релізу) |
1. Механіка відмови: черги блокувань та вичерпання з'єднань
Коли до таблиці з мільйонами рядків надходить прямий DDL-запит:
- DDL чекає звільнення блокування від активних читань.
- Усі нові клієнтські транзакції блокуються очікуючим DDL.
- Пул підключень вичерпується за лічені секунди, спричиняючи падіння застосунку.
Єдине надійне рішення - розділення зміни структури бази даних та оновлення коду на чотири незалежні фази, де жодна операція не блокує трафік.
2. 4-фазний життєвий цикл Expand-and-Contract
Патерн структурує будь-яку нетривіальну модифікацію схеми на чотири безпечні етапи:
NULLABLE без дефолтних значень. Старий код продовжує працювати без змін.3. Подвійний запис через Server Actions у Next.js 16
На другій фазі кожна мутація записує дані в стару та нову тіньову структури. Щоб уникнути подвійних затримок, ми використовуємо асинхронну синхронізацію:
// src/server/services/customer-migration-service.ts
import { db } from '@/server/db'
import { shadowSyncQueue } from '@/server/queues/shadow-sync'
import type { CustomerUpdateInput } from '@/types/customer'
export async function mutateCustomerProfile(
customerId: string,
input: CustomerUpdateInput
) {
// 1. Запис в основну колонку (поточне джерело істини)
const updatedCustomer = await db.customer.update({
where: { id: customerId },
data: {
firstName: input.firstName,
lastName: input.lastName,
updatedAt: new Date(),
},
})
// 2. Асинхронна відправка у чергу тіньової синхронізації
await shadowSyncQueue.add(
'sync-customer-shadow',
{
customerId,
fullName: `${input.firstName} ${input.lastName}`.trim(),
version: 2,
},
{
attempts: 5,
backoff: { type: 'exponential', delay: 200 },
removeOnComplete: true,
}
)
return { success: true, customerId: updatedCustomer.id }
}4. Контрольований перенос історичних даних (Ghost Backfill)
Оновлення мільйонів старих записів одним SQL-запитом перевантажує журнал транзакцій (WAL). Ми використовуємо фоновий воркер із курсорною пагінацією:
// src/server/workers/migration-backfill-worker.ts
import { db } from '@/server/db'
export async function processBackfillBatch(batchSize = 500, lastId: string | null = null) {
const records = await db.customer.findMany({
take: batchSize,
skip: lastId ? 1 : 0,
cursor: lastId ? { id: lastId } : undefined,
where: { fullNameShadow: null },
select: { id: true, firstName: true, lastName: true },
orderBy: { id: 'asc' },
})
if (records.length === 0) return { isCompleted: true, processedCount: 0 }
const updates = records.map((r) =>
db.$executeRaw`
UPDATE "Customer"
SET "fullNameShadow" = ${(r.firstName + ' ' + r.lastName).trim()}
WHERE "id" = ${r.id} AND "fullNameShadow" IS NULL;
`
)
await db.$transaction(updates)
return { isCompleted: false, processedCount: records.length, lastId: records[records.length - 1].id }
}5. Канареєчна звірка та перемикання читання
Перед повним перемиканням читання на нову структуру частина запитів порівнює дані між обома колонками, гарантуючи відсутність розбіжностей:
6. Метрики продакшну та стабільність
| Показник | Прямий ALTER TABLE | Патерн Expand-and-Contract | Ефект |
|---|---|---|---|
| Тривалість блокування таблиці | 42.6 секунди | 0.00 секунд (Блокування відсутнє) | 100% усунення |
| Рівень помилок 504 під час DDL | 18.4% запитів | 0.00% (Жодного збою) | Повна стабільність |
| Швидкість відкату (Rollback) | Небезпечно (з бекапу) | < 1 секунди (Перемикання прапорця) | Миттєвий відкат |
Висновок
Еволюція структури даних є фундаментальною перевіркою зрілості архітектури. Використання патерну Expand-and-Contract, подвійного запису у Server Actions та фонового бекфілу дозволяє оновлювати схеми баз даних будь-якого масштабу без технічних вікон та падіння сервісів.
Де ця архітектура працює у моєму портфоліо
Ці інженерні рішення не є абстрактною теорією - вони повністю реалізовані та перевірені у наступних робочих продуктах:
Artur Yusupov Portfolio Platform
Архітектура еволюції схем та подвійного кешування без простоїв, що обслуговує понад 210 локалізованих маршрутів без технічних перерв.
Unitrition HealthTech Platform
Міграція клінічних схем даних без простоїв, що забезпечує оновлення медичних карт пацієнтів зі 100% зворотною сумісністю та аудитом.
Плануєте міграцію стеку або розробку продукту?
Обговоріть архітектурні вимоги вашого проєкту з інтерактивним RAG AI-асистентом або зв’яжіться напряму для інженерної оцінки.
Інші інженерні статті
Next.js 16 проти Headless WordPress та Custom PHP: об’єктивний аналіз TCO, продуктивності та SEO (2026)
Інженерний аналіз архітектури, витрат на підтримку (TCO) та показників Google Core Web Vitals для Next.js 16, Headless WordPress та кастомного PHP.
Повний розбір архітектури Fullstack AI Lab: компіляція 1 135+ MDX-уроків за 90 секунд на Next.js 16 та Rust MDX-RS
Повний технічний та архітектурний розбір інтерактивної освітньої платформи Fullstack AI Lab: як ми прискорили статичну збірку у 14 разів (із 21.6 хв до 1.5 хв), створили браузерну WebAssembly-пісочницю WordPress, симулятор AI-співбесід, інтерактивні симулятори рантайму та аудіогенератор для NotebookLM.