Přeskočit na obsah

Idempotentní seed hledá záznam podle „A nebo B“ a přepíše cizí záznam se stejným číslem

import { Aside } from ‘@astrojs/starlight/components’;

Skript zakládající testovací účty pro každou roli měl u některých účtů vytvořit i evidenční záznam s pevným číslem. Při zkoušce nad databází, kde stejné číslo už měl jiný záznam, skript skončil s kódem 0 – a cizí záznam měl nové jméno, nový stav a byl přiřazený testovacímu účtu.

„Idempotence“ byla udělaná takto:

const existing = await db.record.findFirst({ where: { OR: [{ user_id: user.id }, { number: wanted }] } });
if (existing) await db.record.update({ where: { id: existing.id }, data: { ...testData, number: wanted } });
else await db.record.create({ data: { ...testData, number: wanted } });

Podmínka OR má zajistit, že opakované spuštění najde vlastní záznam. Stejně dobře ale najde cizí záznam se stejným číslem – a kód nerozlišuje, jestli nalezený záznam založil on sám. „Vyhrazené číslo“ bylo jen v komentáři.

Stejný vzor byl u účtů: upsert podle e-mailu přepsal heslo a role jakéhokoli účtu se shodnou adresou.

Dvě související pasti téže evidence:

  • číslo je jedinečné i přes měkce smazané záznamy, takže „po testu smazat“ číslo neuvolní;
  • další číslo se přiděluje jako max + 1, takže testovací záznam s vysokým číslem posune číslování všem dalším skutečným záznamům.
  • Důkaz původu: každý záznam založený seedem dostane auditní značku (akce + typ + ID). Seed mění jen záznamy s touto značkou.
  • Ověření předem: před prvním zápisem projdi všechny cíle a posbírej kolize – cizí účet s e-mailem, cizí (i smazaný) záznam s číslem, nesouhlasící vazba, chybějící číselník. Při jakékoli kolizi skonči chybou a vypiš všechny důvody.
  • Jedna transakce pro všechny zápisy, aby pád uprostřed nenechal polovinu.
  • Čísla bez výchozí hodnoty – zadává je člověk po ověření proti skutečným datům.

Druhé kolo – kontrola musí platit i v okamžiku zápisu. Ověření předem uvnitř transakce nestačí: při výchozí izolaci (READ COMMITTED) je to obyčejné čtení a jiná transakce může vazbu změnit mezi kontrolou a zápisem. Starý plán ji pak tiše přepíše. Správné pořadí:

  1. úvodní čtení jen k určení, co zamknout;
  2. zámky dotčených existujících záznamů – stejné poradní zámky a pořadí jako aplikace a navíc SELECT … FOR UPDATE (blokuje i přímý zápis mimo aplikaci);
  3. nové čtení a rozhodnutí až po zámcích; záznam, který se objevil mezi čtením a zámky, je konflikt;
  4. zápis existujícího záznamu podmíněný stavem, podle kterého se rozhodlo (updateMany … where + kontrola počtu).

Souběh se testuje ve dvou skutečných transakcích a v obou pořadích: změna potvrzená před zámky = konflikt; změna zahájená během zápisů čeká na dokončení a potom se provede (ověřit bariérou s časovým limitem, ne vynuceným selháním).

Testy: opakování vlastních záznamů, cizí číslo, smazaný cizí záznam s číslem, cizí e-mail, nesouhlasící vazba, chybějící číselník, pád uprostřed zápisů. Ověř mutací (vrať chybnou podmínku), že testy opravdu selžou.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: grep -rn "OR: \[" prisma/ scripts/ a hledej findFirst následovaný update; každý upsert v seedu podle přirozeného klíče (e-mail, číslo, název).
  • Anti-pattern: považovat „najdu-li, aktualizuji“ za bezpečnou idempotenci; spoléhat na rezervaci v komentáři; ověřovat seed jen na prázdné databázi.
  • Lepší přístup: seed spouštěný mimo čistě vývojovou databázi ber jako migraci dat – s ověřením předem, konfliktem místo přepisu a zkouškou nad databází, kde cíle už někomu patří.

Sister bugs / související

Sekce “Sister bugs / související”
Přidal aiarchitekt.cz · 16. 11. 2026 1:00
Provozuje aiarchitekt.cz