5 návyků, které udrží API kompatibilní i po změně datového modelu

Z Mazovia

NoSQL není jedna technologie, ale skupina databázových systémů, které se odlišují od relačních tabulek. Patří sem dokumentové databáze ukládající JSON, klíč-hodnota úložiště, a grafové databáze. Společné mají to, že obvykle nemají pevné schéma, nevyžadují JOINy a počítají s horizontálním škálováním na mnoho strojů. Neznamená to, že jsou „lepší". Znamenají jiný kompromis: vzdáváte se části záruk relačního modelu výměnou za flexibilitu a propustnost.

Praktický postup: začněte jedním systémem, změřte reálné zatížení a teprve pak zvažte doplnění specializované databáze pro konkrétní část aplikace. Často stačí relační databázi dobře nastavit a doplnit cache nebo vyhledávací index. Hybridní přístup má ale svou cenu — dvě úložiště znamenají dvě zálohy, dvě migrace a riziko, že se data rozejdou. Pokud se pro NoSQL rozhodnete, napište si dopředu, jak budete řešit zálohování, obnovu a změny tvaru dat, protože bez schématu se chyby neprojeví při zápisu, ale až při čtení.

Technický pohovor u juniora většinou neznamená složité algoritmy. Často dostanete menší úlohu nebo úryvek kódu k diskusi. Cílem je vidět, jak přemýšlíte, jak kladete otázky a jak reagujete na zpětnou vazbu. Když něco nevíte, řekněte to a navrhněte, jak byste to zjistili. Předstíraná jistota působí hůř než přiznaná mezera. Před pohovorem si projděte vlastní projekt a připravte si odpovědi na otázky typu proč jste zvolili tuto strukturu, jak byste přidali novou funkci a kde vidíte slabá místa.

Jak vypadá první pohovor a co na něm rozhodu

Rozsahové filtry vždy validujte a uzavírejte. Neomezený dotaz bez horní hranice data vrátí celou tabulku a každý útočník toho využije. Zároveň nastavte maximální velikost stránky, typicky mezi padesáti a dvěma sty záznamy, a vynucujte ji na serveru, ne jen v dokumentaci. Klient, který požádá o deset tisíc záznamů, dostane chybu nebo oříznutou odpověď s jasnou informací, jak pokračovat.

Před psaním scénáře si sedněte s analytikem a vývojářem a rozepište příběh na akceptační kritéria. Pište je jako pozorovatelné stavy, ne jako technické kroky. Místo „uživatel klikne na tlačítko Uložit" použijte „po uložení se objednávka objeví v přehledu se stavem nová". Každé kritérium by mělo mít jasný vstup, očekávaný výsledek a způsob, jak poznáte, že nastal. Když kritérium nejde ověřit bez pohledu do databáze, rozdělte ho na dvě části — jednu pro rozhraní a jednu pro integrační test.

Na závěr: navrhujte API podle toho, co klient potřebuje, ne podle toho, jak je databáze postavená dnes. Držte stabilní identifikátory, neměňte význam polí, připravte verzování a testujte staré klienty proti novému rozhraní. Tím se změna modelu stane rutinou místo odstávky.

Data připravujte předem a oddělte je od kroků. Testovací scénář nemá obsahovat konkrétní jméno zákazníka, pokud na něm nic nezávisí. Používejte stabilní testovací účty a jasně označená data, která jde po testu uklidit. Pokud scénář potřebuje stav, který vzniká složitě, zapište barvy stěn do obýváku poznámky, jak ho vytvořit, nebo rovnou připravte skript. Bez toho se scénář stane neopakovatelným a při dalším běhu selže z jiného důvodu, než se testuje.

Na co si dát pozor v praxi Nejčastější chyba je vybrat databázi podle popularity a pak modelovat data jako v relačním světě. Dokumentová databáze není náhrada tabulek s cizími klíči; data se do ní vkládají duplicitně a musíte mít jasno, kdo je vlastníkem pravdy a jak zajistíte konzistenci při aktualizaci. Před nasazením si napište pět až deset reálných dotazů a ověřte, že je databáze umí efektivně. Zvlášť u agregací a řazení narazíte na omezení, která se v relačním modelu řeší jedním JOINem.

Transakce a konzistence si zaslouží samostatné rozhodnutí. Některé NoSQL systémy nabízejí transakce jen v rámci jednoho dokumentu nebo klíče, jiné je přidaly později a s jinými zárukami. Než se spolehnete na „eventual consistency", projděte scénáře, kdy uživatel vidí neaktuální stav, a rozhodněte, zda je to přijatelné. Tam, kde jde o peníze, skladové zásoby nebo rezervace, bývá jednodušší a bezpečnější zůstat u relační databáze s ověřeným transakčním modelem.

Při návrhu se ptejte, co se stane, když se entita rozdělí nebo sloučí. Pokud odpověď zní „všechno se rozbije", je návrh špatný. Pomáhá psát testy kompatibility: stará verze klienta proti novému API. Chyby se objevují hlavně u povinných polí, u změn formátu data a času a u tichého zaokrouhlování čísel. Všechna tato místa dokumentujte jako součást kontraktu, ne jen v komentáři v kódu.

Druhý častý problém je podceněné indexování a plánování klíčů. U klíč-hodnota úložišť rozhoduje návrh klíče o všem: špatně zvolený prefix vytvoří horká místa a výkon se rozpadne právě ve chvíli, kdy roste provoz. U dokumentových databází zase platí, že dokument nemá být nekonečně velký; rostoucí pole v jednom dokumentu dřív nebo později narazí na limity a přepisování celého objektu je drahé. Data proto rozdělujte podle toho, co se čte a mění společně.