Selo de estado:
Preview(limite atual do produto) · Atualizado em 2026-10-03. Fonte de estado: matriz de estados do produto. Sem SLA.
Três ações diferentes, três botões diferentes:
| Ação | Botão | O que faz |
|---|---|---|
| Ligar a repetição | Ativar agenda | Passa a disparar a execução no horário configurado. Não executa nada na hora. |
| Rodar uma vez | Executar agora | Cria uma execução imediata da versão publicada. Não liga a agenda. |
| Parar a repetição | Pausar agenda | Desliga a repetição e limpa o próximo horário. A pausa persiste — ela não volta sozinha na próxima publicação nem no dia seguinte. |
O fuso, sem ambiguidade#
Desde 03/10/2026, você escolhe e lê a agenda no horário de Brasília — o mesmo do relógio da sua empresa:
- No cartão Agendamento do pipeline, o campo é rotulado Horário (Brasília), com a dica "Prefira a madrugada: o sistema de origem costuma estar mais livre."
- O resumo do agendamento aparece como, por exemplo,
Agendado · Diário às 02:00 (Brasília). - Na montagem do pipeline, o quadro Próximas cinco ocorrências mostra os próximos disparos antes de você ligar qualquer coisa.
- Na tela Execuções, datas e horários também estão no horário de Brasília.
Por baixo, o produto guarda o instante em UTC — é por isso que o painel de recuperação, ao pedir um período, fala em Do dia (inclusive, UTC).
Horário de execução ≠ período processado
O horário da agenda diz quando o pipeline roda. O intervalo de dados que ele processa é definido pelo modo de carga (watermark, partição, janela). Ver ingestão incremental e backfill.
Antes de começar#
- O pipeline precisa estar publicado (existe uma versão).
- Ser dono do workspace.
- Assinatura em dia: a execução é uma ação cara e é bloqueada em atraso, suspensão ou cancelamento.
Passo a passo#
1. Abra o pipeline
Em ETL/ELT → Pipelines, abra o pipeline publicado.
2. Configure o horário
No cartão Agendamento do pipeline, clique em Editar agendamento, escolha Todo dia, num horário e informe o Horário (Brasília). Grave em Salvar agendamento — salvar só muda o horário, não liga nada.
3. Ative
Use Ativar agenda. A tela passa a mostrar o próximo horário.
4. (Opcional) Rode uma vez agora
Use Executar agora se quiser uma carga imediata. Revise contexto, versão e destino antes de confirmar.
5. Para parar
Use Pausar agenda. O próximo horário é limpo e o evento fica na auditoria.
Resultado esperado#
- Com a agenda ativa, a tela mostra o próximo horário, no horário de Brasília.
- Com a agenda pausada, a tela mostra a agenda como inativa e não há próximo horário.
- Ativar agenda não dispara recuperação histórica. Períodos anteriores só são processados se você pedir explicitamente um backfill.
Se algo der errado#
| Sintoma | O que conferir | Próxima ação |
|---|---|---|
| Rodou três horas antes/depois do esperado | Se o horário foi pensado em UTC (como o campo era até 03/10/2026) | Abra Editar agendamento e confira o Horário (Brasília) |
| Agenda ativa e nada rodou | Situação comercial, chave de desligamento da capacidade, limite de concorrência | Confira Planos e a mensagem na tela de execuções |
| Pausei e voltou sozinha | Se alguém republicou e reativou | A pausa persiste no produto; confira a auditoria |
| Quero só uma carga de teste | — | Use Executar agora sem ativar a agenda |
Limites e custos#
- Ativar ou pausar agenda: R$ 0.
- Cada execução consome recursos de nuvem, cobrados em créditos.
- Não há promessa de tempo de execução: depende do volume e da origem.
Próxima tarefa#
Última revisão: 2026-10-03.