← Cloudflare Queues / queues / reference

Záruky doručení

Záruky doručení určují, jak striktně systém zpráv vynucuje doručení zpracovávaných zpráv.

Čím silnější záruky doručení zpráv chcete, tím více kontrol a potvrzení musí systém provádět, aby zajistil doručení zpráv, případně udržovat stav, který zaručí, že se zpráva doručí jen stanovený počet krát. Tím se zvyšuje latence systému a snižuje se jeho celková propustnost. Každá zpráva si může vyžádat další interní potvrzení a odpovídající počet dalších síťových cest, než ji lze považovat za doručenou.

• Queues poskytují alespoň jednou doručování ve výchozím nastavení za účelem optimalizace spolehlivosti.
• To znamená, že doručení zprávy je garantováno minimálně jednou, ve výjimečných případech však může být doručena i vícekrát.
• Pro většinu aplikací jde o správnou rovnováhu mezi tím, aby nedocházelo ke ztrátě zpráv, a minimalizací celkové latence, protože doručení právě jednou přináší v jakémkoli systému zpráv dodatečnou režii.

V případech, kdy by opakované zpracování stejné zprávy vedlo k nežádoucímu chování, vygenerujte při zápisu zprávy do fronty jedinečné ID a použijte ho jako primární klíč při vkládání do databáze a/nebo jako idempotentní klíč pro odstranění duplicit po zpracování. Pokud například tento idempotentní klíč použijete jako ID v nadřazeném e-mailovém nebo platebním API, tyto služby za vás duplicitu odmítnou, aniž byste museli v aplikaci udržovat další stav.