Scheduler — aba Calendário

"Quando essa carga roda?" era uma pergunta que só um padrão técnico de seis campos respondia — e um padrão desses não responde nada para quem abre a tela. A aba Calendário mostra, no mesmo calendário, o que já rodou e o que vai rodar, e deixa você montar a repetição escolhendo a forma e o horário.

Fica em DATTA Extract › Scheduler, aba Calendário.

Uma tela, três abas

O Scheduler reúne, numa tela só, tudo que responde por quando e como as cargas rodam:

Antes eram três destinos separados no menu (dois no DATTA Extract e um em Configurar). Eram a mesma pergunta partida em três lugares: quem via uma falha no calendário tinha de sair da tela para abrir o detalhe da execução, e quem precisava pausar a carga saía de novo para outra área da plataforma.

Endereços antigos continuam valendo. view=pipeline-agenda, view=pipeline-monitor e view=datta-scheduler abrem o Scheduler já na aba correspondente — link salvo, favorito e atalho antigo não quebram.

O calendário

Cada dia do mês mostra três contagens, quando existem:

Clique em um dia para abrir o painel lateral com a lista. Clique em uma execução para ver o detalhe: duração, linhas lidas e gravadas, avisos, o erro (com o estágio em que ele aconteceu) e quanto cada nó do fluxo processou.

Os filtros no topo restringem por pacote e por status.

O horário previsto é o horário real. A previsão do calendário é calculada pelo mesmo código que dispara a execução — não é uma estimativa paralela. Se a tela diz 04:30, é 04:30 que o agendador vai usar.

Montar a repetição

No painel de um dia, o botão Editar agendamento abre o editor.

O mesmo editor, alcançável de três lugares. Ele não é exclusivo desta aba: o botão Agendar da barra do ETL Designer e a ação Agendar execução do menu de cada pacote na galeria abrem exatamente este diálogo — mesmos campos, mesma prévia, mesma gravação. Quem acabou de montar o fluxo agenda sem vir até aqui procurar o pacote no calendário. Ver DATTA Extract §4.5.

Escolha a forma de repetição:

São essas quatro, e só essas. Não existe mais um campo para digitar padrão de agendamento técnico: quem monta a repetição escolhe a forma e o horário, e a plataforma cuida do resto. Pacotes criados antes disso continuam funcionando — veja "Agendamento antigo", logo abaixo.

Enquanto você monta, a prévia lista as próximas execuções. Um agendamento inválido (semanal sem nenhum dia marcado, horário fora do formato HH:mm, janela invertida) aparece com a explicação em português e o botão de salvar fica desabilitado — nada é gravado pela metade.

Se o horário passar com a plataforma fora do ar

O editor tem uma segunda escolha, logo abaixo da repetição:

Em qualquer das duas, a falta é sempre registrada. Antes, uma janela perdida simplesmente não acontecia e nada apontava para isso — quem descobria era o consumidor do dado, um dia depois. As faltas de cada pacote ficam listadas na aba Motor, com o horário e o que a plataforma fez.

"Executar uma vez" repõe uma carga, não uma por horário perdido: três dias de janela não viram três execuções iguais em sequência, que derrubariam o destino em vez de recuperá-lo.

Agendamento antigo

Pacote criado antes do editor visual — inclusive os pacotes que já vêm com a plataforma — abre normalmente:

• Quando a repetição antiga tem equivalente entre as quatro formas, o editor já abre com os campos preenchidos e avisa: "foi lido como Todo dia às 04:30 — os horários são exatamente os mesmos". Nada muda no que roda.
• Quando não tem (um padrão que a tela não sabe desenhar), o pacote continua disparando como sempre e o editor mostra "Agendamento personalizado" com as próximas execuções ao lado. Escolher uma das quatro formas substitui o agendamento antigo — e só quando você salvar.

Em nenhum dos dois casos a plataforma mostra o padrão técnico na tela.

Coisas que a repetição resolve e o formato antigo não resolvia

• Intervalo livre. "A cada 90 minutos" não cabia no formato antigo, que só aceitava divisores da hora.
• Vários horários sem efeito colateral. Escolher 08:30 e 14:00 dispara exatamente nesses dois. O equivalente no formato antigo dispararia também às 08:00 e às 14:30 — o cruzamento de minutos com horas.
• Dia 31. Um agendamento mensal no dia 31 simplesmente não ocorre em fevereiro; ele não escorrega para o dia 28 nem para 1º de março.

Janela de validade

Os campos de data (opcionais) delimitam quando o agendamento vale. Depois da data final, o pacote para sozinho — ninguém precisa lembrar de desligar uma carga sazonal ou de migração.

Histórico

Toda execução que termina — concluída, com falha ou cancelada — é gravada de forma durável e passa a aparecer em três lugares:

1. Neste calendário, no dia em que aconteceu, com o detalhe completo;
2. Na aba *Job Monitor*, na tabela de histórico, com busca, filtro de status, ordenação e paginação;
3. No painel Execuções em segundo plano da plataforma, junto com triagem e uploads, como uma execução do tipo etl. Veja Histórico Completo de Execuções.

O histórico sobrevive a reinício e atualização da plataforma, e é filtrável por período — diferente do estado operacional do monitor, que é uma janela do que está acontecendo agora.

Perguntas frequentes

Onde foi parar a tela "Agenda de Cargas"? Ela virou a aba Calendário desta tela. O conteúdo é o mesmo — calendário, painel do dia, editor de repetição — e os endereços antigos abrem o Scheduler já nela.

Meus pacotes antigos usam o formato técnico de agendamento. Preciso reescrever? Não. Eles continuam funcionando exatamente como estão e já aparecem no calendário. O editor lê a repetição antiga e mostra a forma equivalente; o que não tem equivalente aparece como "Agendamento personalizado", com as próximas execuções ao lado. Reescrever é opcional, e só acontece se você escolher uma das quatro formas e salvar.

Uma execução não aconteceu. Como eu descubro? Toda janela perdida fica registrada, com o horário que faltou e o que a plataforma fez (pulou ou repôs). Se você quer que ela seja reposta automaticamente, marque "Executar uma vez ao voltar" no editor do pacote.

Mudei o agendamento e nada apareceu no calendário. Confira a janela de validade: se a data final já passou, não há próxima execução, e a tela diz isso. Confira também se o pacote está ativo — pacote pausado ou arquivado não agenda. A aba Motor mostra o estado de cada pacote e explica, ao lado da repetição, por que um agendamento não rende próxima execução.

Uma execução sumiu do histórico? O histórico começa na primeira execução após a atualização que trouxe esta tela; execuções anteriores continuam no monitor, mas não foram importadas.

Agendei pelo ETL Designer e não vejo aqui. Atualize o calendário: o agendamento é gravado no mesmo pacote, e a aba lê a prévia ao carregar. Se ainda assim não aparecer, confira a janela de validade e se o pacote está ativo — as mesmas duas causas da pergunta anterior.

Não vejo o botão de editar agendamento. Editar o agendamento exige a permissão de editar o pacote (PIPELINE_CREATE, ou perfil administrador). Sem ela o botão não aparece — ver RBAC.

Não consigo pausar um pacote pela aba Motor. Pausar e retomar são operação de plataforma e exigem permissão de administração — ver Motor. As abas Calendário e Job Monitor não dependem dessa permissão.