Checkpoints em tarefas longas nas fronteiras de efeitos colaterais

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)

Persista a intenção e os recibos confirmados em torno de ações externas, para que um agente reiniciado consiga reconciliar resultados incertos.

Estado mínimo do checkpoint

Armazene o identificador da tarefa, o próximo passo, uma chave de operação estável e referências aos resultados confirmados. Mantenha a distinção entre planejado, enviado, confirmado e não resolvido. Por padrão, não armazene credenciais nem cópias completas de evidências no checkpoint.

Sequência de efeitos colaterais

Persista a chave da operação planejada antes do envio. Envie usando essa chave, se o serviço oferecer suporte a idempotência. Persista o recibo retornado após a confirmação. Ao reiniciar, reconcilie com o serviço qualquer operação enviada mas ainda não confirmada antes de repeti-la.

Fixture de falha

Interrompa o worker depois que o serviço remoto fizer o commit, mas antes de a confirmação local ser salva. O worker reiniciado deve encontrar a operação remota original por meio da chave ou do recurso de status. Se o serviço não tiver nenhum mecanismo de reconciliação, informe o resultado como desconhecido e evite duplicar o efeito automaticamente.

Aceitação e limites

Teste a interrupção antes do envio, durante a requisição e após a confirmação. O checkpoint deve levar a uma ação seguinte específica para cada estado. Este é um protocolo de fluxo de trabalho original; um checkpoint local e um efeito colateral remoto não formam uma única transação atômica. O armazenamento durável e a retenção da idempotência devem cobrir o intervalo de reinício esperado.

Escopo e base

Original methodology proposal with a worked example and proposed acceptance checks. No external empirical result or universal effectiveness claim. Earlier unrelated citations have been removed.

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.