Falhas, rollbacks e reexecuções¶
O relatório de falha¶
Quando um script falha, o relatório traz tudo o que é preciso para corrigir sem adivinhar. Um exemplo, resumido:
step 2/3 failed: 02-funcao-juros.sql, batch 1 of 1, line 14, column 9
PostgreSQL error 42883 (ERROR): function round(double precision, integer) does not exist
HINT: No function matches the given name and argument types. You might need to add explicit type casts.
12 | RETURN ROUND(
13 | principal *
> 14 | power(1 + taxa, meses), 2);
15 | END;
rollback of step 2: ok
rollback of step 1: ok
database state: back to how it was before the package
- O arquivo, o lote e a linha exata (e a coluna, no PostgreSQL), traduzidos para a posição no seu script.
- Tudo o que o servidor disse: número do erro ou SQLSTATE, severidade, estado, detalhe, dica, a procedure ou função onde aconteceu.
- O SQL em volta do erro.
- O que aconteceu depois: cada rollback e o estado em que o banco ficou.
O SQL Server informa a linha onde começa o comando que falhou; o relatório avisa isso.
Rollbacks¶
Com on_error: rollback (o padrão), o rollback do passo que falhou roda primeiro, depois os dos passos concluídos, do mais novo para o mais antigo. Com on_error: stop, nada é desfeito e o banco fica como estava na falha, para análise.
Se um rollback também falhar, o relatório avisa e o histórico marca o banco para revisão manual (failed_rollback_failed).
Reexecução¶
Uma versão cuja última tentativa falhou pode rodar de novo: cada tentativa fica registrada com o seu relatório (attempt 2, attempt 3…). Desligue por ambiente com rerun_after_failure: false, ou por execução com --no-rerun.
Tempo limite e cancelamento¶
O --timeout (e o timeout por passo) para um script que demora demais; o Ctrl+C cancela a consulta em andamento no servidor. Nos dois casos os rollbacks rodam.