-- Pasul 2: Exemplu de batch backfill controlat într-o procedură
DO $$
DECLARE
v_batch_size INT := 2500;
v_rows_updated INT := 0;
BEGIN
LOOP
WITH rows_to_update AS (
SELECT id FROM orders
WHERE status_v2 IS NULL
LIMIT v_batch_size
FOR UPDATE SKIP LOCKED
)
UPDATE orders
SET status_v2 = status::text
FROM rows_to_update
WHERE orders.id = rows_to_update.id;
GET DIAGNOSTICS v_rows_updated = ROW_COUNT;
EXIT WHEN v_rows_updated = 0;
-- Lăsăm DB-ul să respire între tranzacții
PERFORM pg_sleep(0.05);
END LOOP;
END $$;Primul instinct când vrei să redenumești o coloană sau să-i schimbi tipul e un simplu ALTER TABLE. La 10.000 de rânduri în SQLite pe local e instant. Pe un Postgres de producție cu o tabelă de 42 de milioane de comenzi, comanda aia îți ține lock exclusiv și-ți prăbușește tot pool-ul de conexiuni în 15 secunde.
Am pățit-o acum vreo 6 ani, când un rename aparent banal a blocat checkout-ul timp de 18 minute. De atunci am trecut exclusiv pe pattern-ul Expand and Contract (sau add-backfill-flip-remove). Nu e vreo magie neagră, dar cere disciplină și deploiamente separate.
1. Add (Expand)
Adaugi coloana nouă, obligatoriu fără constrângeri grele la început. Dacă ai nevoie de NOT NULL, o adaugi inițial ca NULLABLE. Dacă adaugi default values, mare atenție la versiunea de motor SQL; de exemplu, Postgres gestionează safe default-urile doar de la v11 încoace.
Imediat după migrare, actualizezi aplicația să facă dual-write. Orice scriere sau update pe care îl face backend-ul trebuie să populeze atât coloana veche, cât și pe cea nouă. Aplicația continuă să citească exclusiv din coloana veche.
2. Backfill
Datele noi intră în ambele coloane, dar datele istorice sunt încă doar pe coloana veche. Aici intervine backfill-ul.
Regula de aur: nu faci niciodată UPDATE table SET new_col = old_col dintr-un singur foc. Riști să umpli discul cu WAL-uri și să ții locks pe pagini întregi de date. Scrii un worker sau un script care preia ID-urile în tranșe (batch-uri de 2.000 - 5.000 de rânduri), face update-ul, lasă o pauză de 50-100ms între batch-uri ca să poată respira baza de date, apoi continuă.
La volumul de 42 de milioane de înregistrări menționat mai devreme, un astfel de backfill a rulat în fundal aproape 6 ore. Zero impact pe CPU, utilizatorii nici n-au simțit.
3. Flip
Verifici de zece ori consistența: mai există rânduri unde coloana nouă e null? Dacă totul e sincronizat, schimbi codul aplicației. Acum, backend-ul începe să citească din coloana nouă. Păstrezi încă scrierea duală pentru siguranță; dacă descoperi un bug ascuns în parsarea datelor noi, poți da rollback la cod fără să fi corupt starea tabelei.
După 24-48 de ore de monitorizare stabilă, oprești complet scrierile pe coloana veche.
4. Remove (Contract)
Ultimul pas, pe care 80% din echipe uită să-l mai facă: cleanup-ul tehnic. Scoți referințele către coloana veche din codul backend și rulezi ultimul migration care dă DROP COLUMN old_col.
Un pont util pe Postgres: înainte de drop, adaugă un lock timeout strict (SET lock_timeout = '2s';). Dacă există tranzacții lungi care citesc tabela, migrarea ta va eșua elegant în loc să stea agățată la coadă blocând celelalte interogări.
Trade-off-ul sincer
Merge impecabil pentru zero downtime și siguranță absolută, dar e nasol din punct de vedere al vitezei de livrare. Un simplu rename cere acum trei pull request-uri separate, două-trei deploiamente pe producție și monitorizarea unui script de backfill. Dacă ești într-un startup devreme, cu 5.000 de utilizatori activi, pattern-ul ăsta e adesea overkill; planifici 2 minute de mentenanță noaptea și ai terminat.
Voi cum gestionați migrările voluminoase: aveți tooling automatizat pentru backfill sau preferați să trageți scurt frâna de mână într-un maintenance window?