Scheduler Trigger
Saiba mais sobre o Scheduler Trigger e como usá-lo na Digibee Integration Platform.
Quando um pipeline é configurado e publicado com qualquer variável do Scheduler Trigger, é criada uma função para executar o processo em pausas predefinidas. Isso é feito seguindo uma expressão cron definida nas configurações deste tipo de trigger.
Variáveis do Scheduler Trigger
O Scheduler Trigger possui 4 tipos. São elas:
5-Minute Scheduler: possui uma pré-configuração de 5 minutos. Quando você implanta um pipeline com essa variável, as execuções ficam programadas para cada 5 minutos.
30-Minute Scheduler: possui uma pré-configuração de 30 minutos. Quando você implanta um pipeline com essa variável, as execuções ficam programadas para cada 30 minutos.
Midnight Scheduler: possui uma pré-configuração para ser acionada sempre à meia-noite. Quando você implanta um pipeline com essa variável, as execuções ficam programadas para meia-noite.
Custom Scheduler: não possui pré-configuração, permitindo que você customize uma cron expression. Quando você implanta um pipeline com essa variável, as execuções ficam programadas de acordo com a cron expression que você especificou.
O Midnight Scheduler não permite configurar o fuso horário. Dessa forma, a execução acontece à meia-noite do fuso horário UTC, que pode ser diferente do seu fuso horário. Se precisar configurar o Fuso Horário, você pode usar o Custom Scheduler e então definir as informações de recorrência à meia-noite em seus parâmetros.
Parâmetros
Dê uma olhada nas opções de configuração do componente. Parâmetros suportados por expressões Double Braces estão marcados com (DB)
.
Parâmetro | Descrição | Valor padrão | Tipo de dado |
---|---|---|---|
Cron Expression | Expressão que define segundos, minutos, horas e a recorrência da execução em dias de um pipeline. Leia o artigo para mais informações sobre o formato das expressões. Acesse a página para saber como construir as expressões. | N/A | String |
Time Zone | Define sob qual Time Zone o pipeline será executado. Se nenhum Time Zone for definido, o padrão seguido será UTC (por exemplo, 12h UTC corresponde a 9h no fuso horário de São Paulo). | N/A | String |
Maximum Timeout | Tempo limite para que o pipeline processe informações antes de retornar uma resposta (padrão = 30000, limite = 900000). Em milissegundos. Se o processamento exceder essa duração, a execução é encerrada. | 30000 | Inteiro |
Retries | Número máximo de tentativas em caso de falha na execução. | 0 | Inteiro |
Allow Redelivery Of Messages | Se ativado, permite o reenvio da mensagem em caso de falha do Pipeline Engine. Consulte o artigo sobre o Pipeline Engine para obter mais detalhes. | False | Booleano |
Allow Concurrent Scheduling | Indica se o pipeline deve seguir a regra, isto é, iniciar a execução mesmo que existam execuções prévias em processamento. | False | Booleano |
Informações adicionais sobre parâmetros
Allow Concurrent Scheduling
Se um pipeline estiver configurado para executar a cada 3 minutos e uma execução anterior levar 4 minutos, este parâmetro determina se a próxima execução começa ou aguarda a execução em andamento. Nesse caso temos cenários diferentes:
se habilitado: a execução seguinte acontece simultaneamente com a atual.
se desabilitado: a execução seguinte, além das demais, não será iniciada até que a execução anterior seja finalizada.
Scheduler Trigger em Ação
Esse trigger pode ser usado em alguns casos em que é necessário buscar dados de sistemas que não têm capacidade de enviar os dados para a Digibee utilizando HTTP, REST, HTTP File, Kafka, RabbitMQ e JMS. Alguns desses cenários são:
buscar arquivos em diretórios SFTP, FTP, S3, Google Cloud Storage, etc.;
buscar informações diretamente em bancos de dados (nesse caso, recomendamos a utilização do componente Stream DB com paginação);
executar chamadas de verificação de status em endpoints da Digibee Integration Platform que não têm capacidade de sensibilizar os pipelines através de webhooks.
Veja a seguir como o trigger se comporta em determinada situação e a sua respectiva configuração:
Cenário: Pipeline executado a cada 30 segundos, sem sobreposição usando uma fonte de dados estática
Observe como configurar um pipeline com o Scheduler Trigger para ser executado automaticamente a cada 30 segundos sem que aconteça uma sobreposição de execuções. Também será configurado um Timeout de 2 minutos e que siga o Time Zone de São Paulo (UTC-3).
Primeiramente, crie um novo pipeline e configure o trigger. A configuração pode ser feita da seguinte forma:
Agora observe como configurar um MOCK no pipeline para que ele seja o provedor de dados que o endpoint retorna ao final. Coloque o componente indicado, conecte-o ao trigger e configure-o com o seguinte JSON:
Feito isso, a cada vez que o pipeline for executado, o JSON definido como resposta será retornado automaticamente.
Atualizado