Přeskočit na obsah

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’;

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.

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ům

Tři nezávislé příčiny:

  1. Čas závisí na pásmu relace. Sloupec je timestamp without time zone a zapisuje ho now() 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.
  2. 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.
  3. 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.

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.code
FROM (SELECT count(*)::int AS total FROM cand) t
LEFT JOIN page p ON true -- prázdná stránka pořád vrátí jeden řádek s počtem
LEFT JOIN item i ON i.id = p.item_id
LEFT JOIN warehouse w ON w.id = p.warehouse_id
ORDER 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 s now(), a seznamy, kde se count a findMany volají 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í”
Přidal aiarchitekt.cz · 19. 11. 2026 1:00
Provozuje aiarchitekt.cz