Provozní skript posoudí pojistku před transakcí a přepíše souběžnou ruční změnu
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Skript pro nasazení měl doplnit nová oprávnění do systémových rolí a zastavit se, kdyby v databázi našel cokoli neočekávaného (například ruční úpravu role v administraci). Při souběhu s ručním uložením role skončil kódem 0 a hlásil „rozdílů 0“ – a ruční úprava byla pryč. Při běžném spuštění bez souběhu se chyba neprojeví, takže zkouška „náhled, zápis, opakování“ byla celá zelená.
Root cause
Sekce “Root cause”Tři věci dohromady:
- Rozhodnutí mimo transakci. Skript přečetl role, spočítal rozdíl a posoudil ho jako bezpečný. Teprve potom otevřel transakci a zapsal. Mezi čtením a zápisem se mohlo potvrdit cokoli.
- Nepodmíněný zápis celé hodnoty. Zápis nebyl vázaný na stav, který pojistka posuzovala (
upsertcelého pole oprávnění). - Kontrola po zápisu ověřovala sebe samu. Porovnala právě zapsaný stav s předlohou – ten samozřejmě sedí. Ztracenou změnu takto vidět nejde.
const diffs = await readDiffs(db); // čtení mimo transakciif (diffs.some(unexpected)) stop(); // pojistka platí jen pro tento okamžikawait db.$transaction(roles.map(upsert)); // nepodmíněný zápisconst after = await readDiffs(db); // „0 rozdílů“ – porovnává už přepsaný stavDruhý směr souběhu je zákeřnější: běžný editor v aplikaci zapisuje celé pole naslepo (bez podmínky na předchozí stav). Když jeho uložení čeká na zámky skriptu, proběhne hned po potvrzení skriptu a změnu skriptu zase odebere. Vlastní poradní zámek skriptu nepomůže – editor ho nebere.
Fix
Sekce “Fix”- Jedna transakce: nejdřív zamknout všechny dotčené řádky v pevném pořadí (
SELECT … ORDER BY klíč FOR NO KEY UPDATE– stejný zámek jako běžnéUPDATE, neblokuje vkládání řádků s cizím klíčem), rozdíl spočítat ze zamčených řádků a teprve pak rozhodnout. - Zapisovat jen sloupce a řádky, které se mají změnit; při jakémkoli neočekávaném rozdílu
ROLLBACKa nenulový návratový kód. Žádný přepínač „přepiš i tak“. - Před potvrzením zjistit čekající transakce a v takovém případě nezapisovat:
SELECT count(*) FROM pg_locksWHERE NOT granted AND pg_backend_pid() = ANY(pg_blocking_pids(pid));- Po potvrzení přečíst stav ještě jednou mimo transakci (s krátkou prodlevou). Rozdíl ohlásit, ruční změnu nepřepisovat.
SET LOCAL lock_timeout, aby skript při drženém zámku neskončil viset.
Zkouška obou pořadí se skutečnými transakcemi: (A) druhá transakce drží zámek, změní řádek a potvrdí – skript na ni prokazatelně čeká (pg_blocking_pids) a po uvolnění se zastaví; (B) třetí transakce drží poslední řádek v pořadí zamykání, skript tedy drží ostatní a čeká, mezitím se spustí zápis naslepo, který prokazatelně čeká na skript – skript ho před potvrzením pozná a vrátí se.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: v každém jednorázovém skriptu hledej vzor „čtení →
if→ transakce se zápisem“. Otázka do review: „Ze kterých řádků se pojistka počítá a jsou v tu chvíli zamčené?“ - Anti-pattern: kontrola po zápisu, která porovnává databázi s tím, co skript sám zapsal; zkouška jen bez souběhu; přepínač pro obejití pojistky.
- Lepší přístup: rozhodovat pod zámkem, zapisovat podmíněně, zjišťovat čekající transakce, po potvrzení ověřit znovu. Zbývající okno (zápis, který dorazí mezi kontrolou čekajících a potvrzením) přiznat a pokrýt samostatným náhledem v postupu nasazení.