O que é um agendamento?
Um agendamento é um gatilho baseado em cron ligado a um contexto. Quando ele dispara, o Matcher lança uma execução de conciliação para esse contexto usando as regras e as fontes ativas dele.
Ciclo de vida do agendamento
Os agendamentos têm um ciclo de vida CRUD completo em
/v1/contexts/{contextId}/schedules.
Como criar um agendamento
Forneça uma
cronExpression. O campo enabled assume ativo como padrão quando omitido.
cURL
String
obrigatório
Expressão cron que define a frequência de execução (1–100 caracteres), com pelo menos cinco minutos entre disparos. O Matcher rejeita agendamentos por minuto e abaixo de um minuto
Boolean
Se o agendamento fica ativo imediatamente
id, o nextRunAt e os timestamps dele. Listar agendamentos (GET) retorna cada agendamento do contexto, habilitados e desabilitados igualmente.
Pausar vs. excluir um agendamento
Quando você precisar parar uma conciliação recorrente, tem duas opções. Desabilite o agendamento para pausar as execuções automáticas mantendo a configuração e o histórico dele. Reabilitar depois é uma única chamada, sem precisar recriá-lo. Atualize a expressão cron, alterne
enabled ou faça os dois (os campos omitidos ficam inalterados):
cURL
DELETE .../schedules/{scheduleId}) apenas quando a cadência tiver acabado de vez. A exclusão é permanente. Para dar uma pausa, desabilite.
Boas práticas
Alinhe a cadência com a disponibilidade das fontes
Alinhe a cadência com a disponibilidade das fontes
Agende as execuções para disparar depois que todas as fontes do contexto entregarem os dados delas do período. Rodar antes de a ingestão terminar produz exceções evitáveis.
Prefira desabilitar a excluir
Prefira desabilitar a excluir
Para pausar uma cadência de conciliação, desabilite o agendamento. Ele mantém o histórico e a configuração, e reabilitar é uma única chamada.
Use expressões cron explícitas
Use expressões cron explícitas
Mantenha as expressões cron legíveis e documentadas (por exemplo
0 0 * * * = diariamente às 00:00). Verifique as suposições de fuso horário do seu deploy antes de depender de um agendamento para execuções sensíveis a SLA.Próximos passos
Contextos e fontes
Configure os contextos e as fontes que um agendamento concilia.
Geração de relatórios
Revise os resultados produzidos pelas execuções agendadas.