Stručne: Aby zmena databázy nikoho nezastavila, spúšťajte migráciu pred nasadením nového kódu a iba „doprednou cestou“ — pridávajte, nemažte. Migrácia musí zniesť aj dvojité spustenie, pred ňou si urobte záchranný bod a po nej overte výsledok priamym dotazom.
Zmena databázy je chvíľa, keď sa aj skúsenému programátorovi spotia ruky. Kód sa dá vrátiť jedným kliknutím. Dáta nie vždy. Tu je postup, ktorý používam, aby nasadenie zmien v databáze nikoho nezastavilo.
Hlavné pravidlo: najprv databáza, potom kód
Predstavte si, že nová verzia aplikácie číta stĺpec splatnost_dni. Ak nasadíte kód skôr než pridáte stĺpec, každá požiadavka, ktorá ho potrebuje, spadne. Ak najprv pridáte stĺpec, stará verzia aplikácie ho jednoducho ignoruje a nová ho po nasadení začne používať.
Preto:
- Migrácia — pridať to, čo nový kód potrebuje.
- Overenie — pozrieť sa priamo do databázy, že zmena naozaj je.
- Kód — nasadiť novú verziu.
Opačné poradie = výpadok.
Migrácie len „doprednou cestou“
Dobrá migrácia je aditívna: niečo pridáva, nič neberie.
- ✅ nová tabuľka (
CREATE TABLE IF NOT EXISTS) - ✅ nový stĺpec s rozumnou predvolenou hodnotou alebo
NULL - ✅ nový index
- ⚠️ premenovanie stĺpca alebo tabuľky
- ⛔ zmazanie stĺpca alebo tabuľky hneď v tej istej verzii
Prečo? Počas nasadenia chvíľu beží aj stará verzia kódu. A ak by ste museli kód vrátiť, stará verzia musí s databázou stále fungovať.
Ako premenovať či zmazať bezpečne
Rozložte to do viacerých vydaní:
- Vydanie 1: pridať nový stĺpec. Kód zapisuje do starého aj nového, číta zo starého.
- Vydanie 2: preniesť dáta. Kód číta z nového.
- Vydanie 3 (o niečo neskôr): starý stĺpec zmazať, keď je isté, že ho nič nepoužíva.
Je to pomalšie, ale nikdy vás to nechytí na hrubom.
Idempotentnosť: migrácia spustená dvakrát nesmie uškodiť
Stane sa, že migráciu spustíte omylom druhýkrát. Alebo ju spustí automat na novej inštancii. Dobrá migrácia to znesie:
CREATE TABLE IF NOT EXISTS ulohy_stitky (
uloha_id INTEGER NOT NULL,
stitok TEXT NOT NULL,
PRIMARY KEY (uloha_id, stitok)
);
-- dátová migrácia: pridaj právo len tam, kde ešte nie je
UPDATE roly SET prava = json_insert(prava, '$.faktury[#]', 'spravovat')
WHERE EXISTS (SELECT 1 FROM json_each(roly.prava, '$.faktury') WHERE value = 'upravit')
AND NOT EXISTS (SELECT 1 FROM json_each(roly.prava, '$.faktury') WHERE value = 'spravovat');
Druhé spustenie nič nezmení. Presne to chcete.
Pozor: v SQLite ALTER TABLE … ADD COLUMN nemá IF NOT EXISTS. Druhé spustenie skončí chybou „duplicate column“ — neublíži dátam, ale zapíšte si to, aby vás to neprekvapilo.
Pred migráciou: záchranné lano
- Záloha alebo bod návratu. Niektoré databázy (napríklad Cloudflare D1) vedia vrátiť stav do konkrétnej chvíle. Pred zmenou si ten bod zapíšte.
- Stav pred. Jednoduchý
SELECT, ktorý ukáže, ako dáta vyzerajú teraz. - Skúška na kópii. Migráciu spustite najprv na kópii produkčných dát. Pridajte do nej aj „čudné“ riadky — prázdne hodnoty, zlý formát, staré záznamy.
Po migrácii: overenie, nie viera
Po spustení sa priamo opýtajte databázy:
SELECT COUNT(*) FROM roly WHERE … ; -- zmenilo sa to, čo malo?
Nikdy nehovorte „migrácia je na produkcii“ podľa toho, že ste príkaz spúšťali. Hovorte to podľa toho, čo ste v produkcii videli.
Dátové migrácie a „nič sa nikomu nezmení“
Najcitlivejšie sú migrácie, ktoré menia existujúce dáta — napríklad keď zavádzate nové právo. Dobrý trik: nové správanie zapnite tak, aby sa po nasadení nikomu nič nezmenilo. Všetci, ktorí mali doteraz prístup, dostanú nové právo automaticky. Zúžiť ho môžete až potom, vedome, človeku po človeku.
Používatelia si nevšimnú nič — a to je presne cieľ.
A čo nové inštancie?
Ak vaša aplikácia beží u viacerých zákazníkov (každý má vlastnú databázu), migrácie musia fungovať aj na úplne novej inštancii. Preto je dobré, keď sa dajú spustiť všetky po sebe od začiatku a výsledok je rovnaký ako na starej, postupne aktualizovanej databáze. Pravidelne si to vyskúšajte na prázdnej databáze — odhalí to migrácie, ktoré potichu predpokladali existujúce dáta.
Kontrolný zoznam pred každou migráciou
- Migrácia je aditívna, alebo mám plán na viac vydaní.
- Druhé spustenie nič nepokazí.
- Mám zapísaný bod návratu alebo čerstvú zálohu.
- Vyskúšal som ju na kópii dát aj s „čudnými“ riadkami.
- Viem, akým dotazom overím výsledok.
- Poradie: migrácia → overenie → kód.
- Viem, ako vrátim kód, ak nová verzia nebude fungovať — a stará verzia s novou databázou pobeží.
Časté otázky
Čo keď potrebujem zmeniť typ stĺpca?
V SQLite to priamo nejde. Postup je vytvoriť novú tabuľku so správnou štruktúrou, preniesť dáta a tabuľky vymeniť. Robte to v transakcii a na kópii si to vyskúšajte najprv.
Musím mať nástroj na migrácie?
Nemusíte, ale pomáha evidencia, ktoré migrácie už prebehli. Stačí aj jednoduchá tabuľka alebo zoznam pri každej verzii aplikácie.
Na záver
Migrácia nie je chvíľa na odvahu, ale na poriadok. Najprv databáza, potom kód. Len pridávať, mazať až neskôr. Zálohu pred, overenie po. S týmito štyrmi pravidlami som ešte nemal výpadok, ktorý by si používatelia všimli.



