Přeskočit na obsah

Jeden sloupec času zapisují dvě konvence — ORM v UTC a raw SQL now() v čase relace

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

Fronta událostí dává čerstvému záznamu desetiminutový odklad, aby ho stihl dokončit požadavek, který ho založil. V databázi s relací v pásmu UTC to fungovalo. V relaci o hodinu na východ plánovaná úloha čerstvý záznam převzala a provedla hned — podle databáze byl „50 minut po lhůtě“. V relaci na západ od UTC se naopak odklad prodloužil o několik hodin. Čekání po chybě a ostatní lhůty přitom fungovaly ve všech pásmech správně.

Sloupec je timestamp without time zone. Zapisovalo do něj sedm míst a jen jedno jinak než ostatní:

// čerstvý záznam — ORM, hodnota z hodin aplikace → uloží se UTC bez pásma
await db.event.createMany({ data: [{ …, nextAttemptAt: new Date(Date.now() + 10 * 60_000) }] });
-- ostatní zápisy a všechna čtení — raw SQL, místní čas relace
UPDATE "Event" SET "nextAttemptAt" = now() + interval '1 hour' WHERE …;
SELECT … FROM "Event" WHERE "nextAttemptAt" <= now();

now() je timestamptz; při zápisu do sloupce bez pásma i při porovnání s ním PostgreSQL použije pásmo relace. Šest zapisovatelů a všichni čtenáři si proto rozuměli. Hodnota od ORM byla proti nim posunutá přesně o posun relace od UTC.

Vadu neodhalí testy, které lhůty „posouvají do minulosti“ pomocným příkazem (ten zapíše now() a rozdíl konvencí zakryje), ani běh v databázi s relací v UTC.

Opraven byl zapisovatel, který se lišil. Čas čerstvého záznamu určují hodiny databáze a zapíše se ve stejné podobě jako u ostatních:

const [{ at }] = await db.$queryRaw<{ at: Date }[]>`
SELECT (clock_timestamp() + make_interval(mins => ${minutes}::int))::timestamp AS at`;
await db.event.createMany({ data: [{ …, nextAttemptAt: at }] });
  • clock_timestamp() je okamžik zápisu; now() by uvnitř delší transakce znamenalo její začátek.
  • Odklad se přičítá před převodem na místní čas bez pásma.
  • Dotaz jde stejným klientem jako INSERT (stejná transakce), nečte žádnou tabulku a nebere zámky.
  • Čtení a ostatní zapisovatelé se nezměnili, takže se nezměnilo čekání po chybě ani už uložené řádky.

Zvažovaná opačná oprava — převést čtení na UTC — by čerstvý záznam také opravila, ale všechny řádky od ostatních zapisovatelů by posunula o pásmo relace (čekání po chybě delší o hodinu či dvě, „splatné hned“ by hodinu čekalo), včetně rozpracovaných řádků z doby před nasazením. Dala by se udělat jen jako sjednocení celého sloupce: všechny zápisy i čtení najednou.

Stav je záměrně jen „zmírněno“: sloupec se dál vede v místním čase bez pásma. Při podzimní změně času je hodina, která nastane dvakrát, nejednoznačná — termín, který padne do jejího prvního výskytu, se přečte o hodinu později. Stejně tak by vadila změna pásma relace mezi zápisem a čtením.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: najdi sloupce timestamp bez pásma, do kterých zapisuje ORM i raw SQL s now() / CURRENT_TIMESTAMP nebo s přetypováním ::timestamp. Stejný sloupec + dvě cesty zápisu = podezření.
  • Mapa před opravou: vypiš zapisovatele (kdo, jakou hodnotu, z jakých hodin) a čtenáře (s čím porovnávají). Většinová konvence určuje, co je „správně“ pro uložená data.
  • Měření: zeptej se databáze na zbývající čas tak, jak ho vidí čtecí podmínka (sloupec - now()), hned po zápisu a bez úprav. Opakuj v relaci UTC, s kladným i záporným posunem.
  • Test: čerstvý záznam ze skutečné cesty a úloha spuštěná jako plánovač, bez pomocného „posunu lhůt“. Pozitivní kontrolu po lhůtě dělej posunem uloženého času přesně o délku odkladu a výslovně ji označ; skutečné uplynutí lhůty ověř zvlášť mimo sadu.
  • Anti-pattern: opravit jedno porovnání podle vzoru z jiného sloupce, aniž víš, kdo do tohoto sloupce zapisuje.
  • Lepší přístup pro nové tabulky: timestamptz, nebo jediná funkce, přes kterou čas do sloupce zapisují všichni.

Sister bugs / související

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