Selo de estado:
Preview(limite atual do produto) · Atualizado em 2026-10-03. Fonte de estado: matriz de estados do produto. Sem SLA.
Reexecutar sem saber o escopo é como apagar um incêndio no escuro. Na tela de detalhe da execução, o botão Recuperar… abre um painel que mostra, antes de você confirmar, exatamente o que será executado de novo.
Antes de começar#
- Ser dono do workspace; assinatura em dia.
- Ter lido o log da tentativa correta — ver acompanhar uma execução.
- Saber o modo de carga do pipeline: ele decide se reprocessar substitui, mescla ou acrescenta.
Os escopos#
| Escopo | O que faz |
|---|---|
| Nova tentativa da tarefa | Repete só aquela tarefa, na mesma execução. |
| Reexecutar tarefa e dependentes | Repete a tarefa e tudo que depende dela no grafo. |
| Executar o pipeline de novo | Cria uma execução nova da versão publicada, do começo. |
| Reprocessar período | Reprocessa uma janela de datas (Do dia / Até o dia, inclusivos). Só recorta de verdade quando a tabela Bronze é Append com coluna-chave; sem isso, a execução recarrega a tabela inteira e o painel pede que você confirme que entendeu. |
A prévia corresponde ao efeito
O painel de recuperação lista as tarefas que serão executadas outra vez. Se a prévia mostra uma tarefa, ela roda; se não mostra, ela não roda. Confira a prévia antes de confirmar.
Passo a passo#
1. Abra a execução que falhou
ETL/ELT → Execuções → a execução → a tarefa → a tentativa.
2. Leia o diagnóstico
Não reexecute antes de entender a causa. Uma credencial expirada não se resolve repetindo a tarefa: corrija a conexão primeiro.
3. Abra Recuperar…
No detalhe da execução, use Recuperar….
4. Escolha o escopo e confira o impacto
O painel tem três passos: Escolher escopo → Conferir impacto → Acompanhar resultado. Em Impacto previsto aparecem as tarefas que vão rodar, as que ficam de fora, o destino e o efeito da escrita. Um escopo indisponível aparece com o motivo, e não como botão morto.
5. Confirme
O botão descreve a operação — por exemplo Confirmar reexecução de {N} tarefa(s) ou Confirmar reprocessamento de {N} dia(s). A recuperação vira uma execução rastreável, como qualquer outra.
Resultado esperado#
O que a prévia mostrou é o que rodou. O destino foi conferido: quantidade de linhas esperada, chaves e valores conhecidos no conjunto de teste.
"Marcar sucesso" não produz dado
Marcar uma tarefa como bem-sucedida muda o estado da execução, não o conteúdo do destino. Use isso apenas quando souber que o dado já está correto por outro caminho — nunca como forma de "resolver" uma carga que não aconteceu.
Se algo der errado#
| Sintoma | O que conferir | Próxima ação |
|---|---|---|
| Reexecutei e duplicou linhas | Modo de carga (acrescentar sem chave duplica por definição) | Ver modos de carga |
| A prévia mostra mais tarefas do que eu esperava | As dependências no grafo | Escolha Nova tentativa da tarefa se quiser o escopo mínimo |
| Reprocessar período avisa que vai recarregar tudo | Se a tabela Bronze é Append com coluna-chave | Sem isso o período fica só registrado; ver ingestão incremental e backfill |
| Falhou de novo pelo mesmo motivo | Se a causa foi corrigida na origem | Corrija a conexão, a permissão ou o schema antes de repetir |
| Mensagem de bloqueio comercial | Situação da assinatura | Regularize em Administração → Planos |
Limites e custos#
- Abrir a prévia: R$ 0. Confirmar a recuperação executa e consome recursos de nuvem como qualquer execução.
- Não há promessa de tempo: depende do volume reprocessado.
Próxima tarefa#
- Telas de Execuções — o nome exato de cada botão
- Tratar uma falha e a DLQ
- Agendamento, retry e DLQ
Última revisão: 2026-10-03.