Fronta řazená podle času materializovaného stavu — pořadí závisí na pásmu relace a stránka se skládá z více čtení
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Obrazovka ukazuje frontu položek ve zvláštním stavu (například zboží v karanténě), nejnovější změna má být nahoře. Tři různé projevy téže slabiny:
- položka změněná dřív se zobrazila nad položkou změněnou později — i na první stránce;
- dvě položky změněné jednou operací měly pořadí dané jen náhodným identifikátorem;
- při souběžné změně odpověď ohlásila jiný celkový počet, než kolik řádků vrátila, nebo ukázala položku, která už ve frontě nebyla, s nulovým množstvím.
Množství i deník pohybů byly přitom správně. Chybné bylo jen pořadí a soudržnost jedné odpovědi.
Root cause
Sekce “Root cause”Fronta se čte z materializované tabulky stavů (položka × sklad × stav) a řadila se podle jejího sloupce updatedAt:
const where = { state: { not: 'free' }, quantity: { gt: 0 } };const total = await db.level.count({ where }); // 1. čteníconst rows = await db.level.findMany({ where, orderBy: { updatedAt: 'desc' }, take, skip }); // 2. čtení// 3. čtení: názvy položek a skladů k vybraným řádkůmTři nezávislé příčiny:
- Čas závisí na pásmu relace. Sloupec je
timestamp without time zonea zapisuje honow()v surovém SQL. Hodnota se uloží v místním čase té relace, která zrovna zapisuje. Zápis v relaci o hodinu „na východ“ vypadá o hodinu novější než pozdější zápis v UTC. - Jedna transakce = jeden čas.
now()vrací začátek transakce. Všechny řádky změněné jednou operací mají čas shodný do mikrosekundy a o pořadí rozhodne druhé kritérium, pokud vůbec nějaké je. - Stránka z více čtení. Počet, výběr stránky a doplnění názvů jsou samostatné dotazy. Změna mezi nimi dá odpověď složenou ze dvou různých stavů světa.
Fix
Sekce “Fix”Pořadí se bere z deníku pohybů. Deník je neměnný a každý záznam má rostoucí pořadové číslo, které nezávisí na hodinách ani na pásmu. Celá stránka se čte jedním příkazem:
WITH cand AS MATERIALIZED ( -- jeden pohled na kandidáty: z něj počet i stránka SELECT id, item_id, warehouse_id, state, quantity FROM level WHERE state <> 'free' AND quantity > 0),last AS ( -- poslední pohyb téhož stavu, položky a skladu (zdroj i cíl) SELECT m.item_id, m.state, v.warehouse_id, max(m.seq) AS seq FROM movement m CROSS JOIN LATERAL (VALUES (m.source_warehouse_id), (m.target_warehouse_id)) v(warehouse_id) WHERE m.state IN ('quarantine', 'blocked', 'claim') AND v.warehouse_id IS NOT NULL GROUP BY 1, 2, 3),page AS ( SELECT c.*, row_number() OVER (ORDER BY c.state, s.seq DESC NULLS LAST, c.id) AS ord FROM cand c LEFT JOIN last s USING (item_id, state, warehouse_id) ORDER BY ord LIMIT $1 OFFSET $2)SELECT t.total, p.*, i.name, w.codeFROM (SELECT count(*)::int AS total FROM cand) tLEFT JOIN page p ON true -- prázdná stránka pořád vrátí jeden řádek s počtemLEFT JOIN item i ON i.id = p.item_idLEFT JOIN warehouse w ON w.id = p.warehouse_idORDER BY p.ord;Podrobnosti, na kterých záleží:
NULLS LAST— řádek stavu bez jediného pohybu (starší data, ruční oprava) z fronty nezmizí, jen je na konci a řadí se podle identifikátoru.LEFT JOIN page ON true— stránka za koncem seznamu vrátí správný celkový počet, ne nulu.- Výčet stavů je v dotazu jako konstanty. S polem předaným za běhu plánovač nepoužil index podle stavu a deník četl celý.
- Žádná migrace a žádný přepis dat: starý sloupec času zůstal, jen se podle něj přestalo řadit.
Jediný příkaz nezaručuje shodu mezi dvěma různými požadavky. Když se sklad mění, druhá stránka může položku přeskočit nebo zopakovat. To je vlastnost stránkování přes OFFSET, ne chyba; kdo ji potřebuje odstranit, musí stránkovat podle klíče.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: hledej
orderBy: { updatedAt: … }nad tabulkou, kterou zapisuje surové SQL snow(), a seznamy, kde secountafindManyvolají zvlášť. - Test pořadí: zapiš starší změnu v jednom pásmu relace a novější v jiném, v obou směrech (kladný i záporný posun), a přidej dvě změny v jedné transakci. Jeden test ve shodném pásmu nic neodhalí.
- Test soudržnosti: vlož souběžnou změnu deterministicky — obal klienta databáze tak, aby po prvním čtení obsluhy spustil připravený zásah. Bez toho je test závodu jen loterie.
- Výkon měř předem: dotaz přes deník je dražší než čtení z materializované tabulky. Změř ho na datech řádově větších než produkce, včetně nejhoršího případu (všechno v nevolném stavu), a rozhodni, jestli je potřeba částečný index.
- Anti-pattern: použít čas poslední změny materializovaného řádku jako „pořadí událostí“. Je to vedlejší produkt zápisu, ne záznam o události.
Sister bugs / související
Sekce “Sister bugs / související”- Jeden sloupec času zapisují dvě konvence — ORM v UTC a raw SQL now() v čase relace — stejná příčina posunu, jiný důsledek.
- Čas převzetí úlohy (lease) zapsaný přes now() závisí na pásmu relace
- Odvozený stav přepočítaný ze snapshotu vlastní transakce — jiná podoba čtení z více okamžiků.
- Prisma orderBy na nullable sloupci řadí NULL poslední
- Test s pojistkou databáze uklízí i po jejím odmítnutí a chybí v seznamu výjimek CI — chyba v regresním testu k této opravě.