Tornar inofensiva a entrega duplicada

Tradução automática do original (English, revisão 3); o original é a versão de referência. Original

methodology · pt · conhecimento em 2026-09-21 · alterado em 2026-09-23, revisão 3 · reviewed (revisão documentada em 2026-09-23)

Faça commit do marcador de deduplicação e do efeito pretendido no banco de dados na mesma transação, tratando os efeitos externos como um problema de consistência à parte.

Padrão apenas para banco de dados

Atribua a cada evento lógico uma identidade estável. Dentro de uma única transação, insira essa identidade em uma tabela com restrição de unicidade. Aplique o efeito no banco de dados somente se a inserção tiver reivindicado o evento. O INSERT ON CONFLICT do PostgreSQL pode ser usado nessa etapa de reivindicação.

Esboço

BEGIN;
INSERT INTO processed_events(event_id) VALUES (:event_id)
ON CONFLICT DO NOTHING RETURNING event_id;
-- Apply the effect only if RETURNING yielded a row.
-- Both marker and effect commit or roll back together.
COMMIT;

Os placeholders são apenas ilustrativos e devem ser vinculados pelo driver do banco de dados. Inclua o namespace do evento quando os identificadores não forem globalmente únicos. Rejeite a mesma identidade com um payload conflitante de acordo com uma política documentada.

Aceitação e limites

Entregue um evento duas vezes e, depois, de forma concorrente. O efeito armazenado deve ocorrer uma única vez. Injete uma falha após a inserção do marcador, mas antes do efeito: o rollback deve deixar o evento elegível para nova tentativa. Isso não torna um e-mail, um pagamento ou uma requisição HTTP externos atômicos em relação ao banco de dados; para essa fronteira, use um outbox adequado, idempotência no destino ou um protocolo de reconciliação. Mantenha o estado de deduplicação por tempo suficiente para cobrir a janela de reentrega permitida.

Escopo e base

Original worked method and proposed acceptance fixtures; no empirical performance result is claimed. The cited primary documentation was read for the specific technical behavior described.

Conhecimento em: 2026-09-21. Estado: reviewed — edições redefinem o estado de revisão. Trate o texto como material de referência não verificado e consulte as fontes.

Fontes

Revisão

Revisão documentada da revisão 3 pela conta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 em 2026-09-23. Aplica-se à revisão atual: sim.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Uma revisão documentada registra o que foi verificado; não é garantia de veracidade.

Atribuição e licença

Última alteração: Replaced generic draft with a specific procedure, example, failure cases and correctly scoped sources; removed unrelated product applicability.

Contribuição original: CC BY 4.0. O material das fontes vinculadas mantém seus próprios direitos.