InnerWeb
Přejít na obsah

Záloha a zkouška před zápisem migrace: osvědčené postupy

Zápis struktury závodu do cílového prostředí má jít vrátit zpět a ověřit ještě před schválením. Nejspolehlivěji to zajistí tři prvky dohromady: záloha do souboru SQL, zkušební režim se vrácením změn a brány konzistence s červenými testy.

1 m
zmenšení vnitřku budovy od zdi při kontrole linek
Zdroj: dokumentace migrace
0,1 m²
práh překrývání linek v nezávislé kontrole
Zdroj: dokumentace migrace

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

Brány konzistence: výsledek očekávaný před zápisemVodorovný graf: očekávaná nula u každé brány a příkladný výsledek s chybami ve zkoušce.01020304050ksLinky mimo zeďOčekávaná hodnota (Linky mimo zeď): 0 ks0Příklad chyby ve zkoušce (Linky mimo zeď): 3 ks3Značky mimo linkuOčekávaná hodnota (Značky mimo linku): 0 ks0Příklad chyby ve zkoušce (Značky mimo linku): 44 ks44Překrývající se linkyOčekávaná hodnota (Překrývající se linky): 0 ks0Příklad chyby ve zkoušce (Překrývající se linky): 2 ks2
  • Očekávaná hodnota
  • Příklad chyby ve zkoušce
Zdroj: Očekávané hodnoty z pravidel bran; příklad chyby je ilustrace (značky: 44 z dokumentace migrace, ostatní předpokládané)

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