Proč tři pojistky a ne jedna
Záloha chrání před ztrátou dat, zkušební režim ukazuje dopady bez zápisu a brány zachytí logické chyby, které žádná záloha neopraví. Každá z nich uzavírá jinou třídu poruch, proto je implementační tým spojuje do jednoho postupu.
Migrace struktury je opakovatelná: každé spuštění sestaví strukturu znovu. Zkoušku lze díky tomu opakovat do úspěchu a cílový zápis je jen jedním ze spuštění.
Postup 1: záloha struktury do souboru SQL před zápisem
Před každým zápisem vytváříme zálohu struktury do souboru SQL. Soubor má název s datem a identifikátorem spuštění a jeho existenci a velikost ověřujeme příkazem vypisujícím obsah adresáře, nepředpokládáme, že vznikl. Záloha umožní obnovit stav před migrací i tehdy, když zápis proběhl, ale špatný výsledek se ukázal až po týdnu.
Brány konzistence: výsledek očekávaný před zápisem
- Očekávaná hodnota
- Příklad chyby ve zkoušce
Postup 2: zápis v jedné transakci se zkušebním režimem
Zápis probíhá v jedné transakci. Zkušební režim provede všechny kroky, spočítá brány a na konci změny vrátí zpět. Výsledkem zkoušky je zpráva: kolik záznamů by vzniklo, kolik se změnilo a kolik bran má hodnotu různou od nuly. Teprve po čisté zprávě spustíme zápis s potvrzením.
Jedna transakce znamená, že přerušení uprostřed nenechá strukturu v mezistavu. Buď celý zápis projde, nebo po něm nezůstane žádná stopa.
Postup 3: brány konzistence s červeným testem
Migrační skript nezapíše data, pokud je některá brána konzistence různá od nuly. Příklady bran: počet čar přesahujících obvod budovy (očekávaná hodnota 0), značky mimo pole své linky, linky překrývající se navzájem. Vnitřek budovy se zmenší o 1 m od zdi a tvar linky se ořeže na vnitřek a kontroluje se vrchol po vrcholu.
Brána bez červeného testu je hypotéza. Proto každá brána má test, do něhož vložíme starou chybu a ověříme, že se brána rozsvítí. Zelený výsledek brány, která nikdy nesvítila na červeno, nic nedokazuje.
Postup 4: druhá kontrola jinou cestou
Po zápisu čteme výsledek nezávislou cestou: přes API editoru, a ne přes týž skript, který zapisoval. Kontrola hledá překrývání linek větší než 0,1 m², linek vstupujících do zdi a špendlíků ležících v lince. Stav porovnáváme podle obsahu, tedy názvu, oblasti, úrovně a geometrie, nikoli podle identifikátorů, protože ty se mění při každém spuštění.
Skript, který hodnotí sám sebe, opakuje vlastní předpoklady. Druhá kontrola je levná a zachytí chyby, které první kontrola považovala za normu.
- překrývání linek větší než 0,1 m²,
- linky vstupující do zdi budovy,
- špendlíky ležící uvnitř linky,
- porovnání podle obsahu, ne podle identifikátorů.
Pořadí kroků v den zápisu
Den zápisu je vhodné rozepsat na kroky, které odškrtáváte postupně: záloha, zkušební režim, přezkoumání zprávy, zápis, druhá kontrola, rozhodnutí o ponechání nebo vrácení. Každý krok má vlastníka a důkaz, například název souboru zálohy, počet bran rovných nule a výsledek nezávislé kontroly.
InnerWeb funguje jako nezávislý systém doplňující systémy klienta, takže zápis struktury nevyžaduje přerušení provozu KD, RCP ani ERP.
Kontrolní seznam
Videomateriál
Často kladené otázky
Stačí záloha, když mám zkušební režim?
Ne. Zkušební režim nechrání před chybou zjištěnou až po schválení, kdežto záloha umožní obnovit stav před migrací.
K čemu je červený test brány?
Brána, která nikdy nesvítila na červeno, nedokazuje, že chybu zachytí. Vložená stará chyba potvrdí, že brána funguje.
Proč porovnávat podle obsahu a ne podle identifikátorů?
Identifikátory se při každém spuštění mění, protože struktura se staví znovu. Název, oblast, úroveň a geometrie zůstávají stálé.
Naplánujme zkušební migraci
S vaším týmem projdeme zálohu, zkušební režim a brány na zkušebních datech. Domluvte si schůzku nebo demo.
Pojďme si promluvit