Pular para o conteúdo

Documentação

Agendamentos

Cron, fuso por agendamento, histórico de execução e o que acontece quando uma execução falha.

A expressão

O agendamento é uma expressão cron de cinco campos. O intervalo mínimo depende do plano: cinco minutos no gratuito, sessenta segundos no Pro e quinze segundos no Business.

Exemplos
0 8 * * 1-5      toda manhã útil, às 8h
0 */15 * * *     de 15 em 15 minutos
30 23 L * *      às 23h30 do último dia do mês

Fuso horário

O fuso pertence ao agendamento, não ao workspace. O workspace só oferece um padrão para o campo vir preenchido; a partir daí cada agendamento carrega o seu. É o que permite que o mesmo relatório saia às 8h em São Paulo e às 8h em Lisboa sem duplicar a consulta.

UTC nunca é escolhido silenciosamente. Se um agendamento está em UTC, é porque alguém escolheu UTC.

Histórico

Cada disparo grava início, duração, linhas retornadas e o erro quando houve. O histórico é mantido pelo tempo do plano: 30 dias no gratuito, um ano no Pro, três anos no Business.

Quando falha

  • A execução é marcada como falha com a mensagem que o banco devolveu, sem reescrita.
  • O agendamento continua ativo; uma falha não desliga o relatório.
  • Se houver alerta de falha configurado, ele dispara pela rota de alerta do workspace.