Agendamentos para gatilhos recorrentes em fluxos de trabalho dos Aplicativos Lógicos do Azure

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)

Os Aplicativos Lógicos do Azure ajudam você a criar e executar fluxos de trabalho recorrentes automatizados em uma agenda. Ao criar um fluxo de trabalho de aplicativo lógico que começa com o gatilho de Recorrência ou o gatilho de Janela Deslizante , que são gatilhos do tipo Agenda, você pode executar tarefas imediatamente, posteriormente ou em um intervalo recorrente. Você pode chamar serviços dentro e fora do Azure, como pontos de extremidade HTTP ou HTTPS, postar mensagens para serviços do Azure, como o Armazenamento do Azure e o Barramento de Serviço do Azure, ou obter arquivos carregados em um compartilhamento de arquivos. Com o gatilho Recorrência , você também pode configurar agendas complexas e recorrências avançadas para tarefas em execução. Para saber mais sobre os gatilhos e ações internos do Agendamento, consulte Agendar gatilhos e Agendar ações.

A lista a seguir mostra alguns exemplos de tarefas que você pode executar com os gatilhos internos do Schedule:

• Obtenha dados internos, como executar um procedimento armazenado SQL todos os dias.

• Obtenha dados externos, como relatórios meteorológicos da NOAA a cada 15 minutos.

• Envie dados do relatório, como enviar por e-mail um resumo de todos os pedidos maiores do que um valor específico na semana passada.

• Processe dados, como compactar as imagens carregadas de hoje todos os dias da semana fora do horário de pico.

• Limpe dados, como excluir todos os tweets com mais de três meses.

• Arquive dados, como faturas push para um serviço de backup à 1h00 todos os dias durante os próximos nove meses.

Você também pode usar as ações internas Agendar para pausar seu fluxo de trabalho antes que a próxima ação seja executada, por exemplo:

• Aguarde até um dia da semana para enviar uma atualização de status por e-mail.

• Atrase o fluxo de trabalho até que uma chamada HTTP tenha tempo para concluir antes de retomar e recuperar o resultado.

Este guia descreve os recursos para os gatilhos e ações internos do tipo Agenda.

Execute cargas de trabalho recorrentes sem criar vários aplicativos lógicos

Você pode agendar e executar cargas de trabalho recorrentes sem criar um aplicativo lógico de consumo separado para cada trabalho agendado e sem atingir o limite de fluxos de trabalho por região e assinatura. Em vez disso, você pode criar um aplicativo lógico padrão com vários fluxos de trabalho ou usar o padrão de aplicativo lógico de consumo criado pelo modelo Azure QuickStart: agendador de tarefas de aplicativos lógicos.

O modelo de agendador de tarefas dos Aplicativos Lógicos do Azure cria um aplicativo lógico chamado CreateTimerJob que chama um aplicativo lógico TimerJob . Em seguida, você pode chamar o aplicativo lógico CreateTimerJob como uma API fazendo uma solicitação HTTP e passando uma agenda como entrada para a solicitação. Cada chamada para o aplicativo lógico CreateTimerJob também chama o aplicativo lógico TimerJob , que cria uma nova instância TimerJob que é executada continuamente com base na agenda especificada ou até atingir um limite especificado. Dessa forma, você pode executar quantas instâncias de TimerJob quiser sem se preocupar com os limites do fluxo de trabalho, porque as instâncias não são definições ou recursos individuais de fluxo de trabalho de aplicativo lógico.

Gatilhos de programação

Você pode iniciar o fluxo de trabalho do aplicativo lógico usando o gatilho Recorrência ou o gatilho Janela Deslizante, que não está associado a nenhum serviço ou sistema específico. Esses gatilhos iniciam e executam seu fluxo de trabalho com base na recorrência especificada, onde você seleciona o intervalo e a frequência, como o número de segundos, minutos, horas, dias, semanas ou meses. Você também pode definir a data e hora de início junto com o fuso horário. Sempre que um gatilho é acionado, os Aplicativos Lógicos do Azure criam e executam uma nova instância de fluxo de trabalho para seu aplicativo lógico.

Aqui estão as diferenças entre esses gatilhos:

• Recorrência: executa seu fluxo de trabalho em intervalos de tempo regulares com base em sua programação especificada. Se o gatilho perder recorrências, por exemplo, devido a interrupções ou fluxos de trabalho desativados, o gatilho Recorrência não processará as recorrências perdidas, mas reiniciará as recorrências com o próximo intervalo agendado.

  Se você selecionar Dia como frequência, poderá especificar as horas do dia e os minutos da hora, por exemplo, todos os dias às 2h30. Se você selecionar Semana como frequência, também poderá selecionar dias da semana, como quarta-feira e sábado. Você também pode especificar uma data e hora de início juntamente com um fuso horário para sua agenda de recorrência. Para obter mais informações sobre formatação de fuso horário, consulte Adicionar um gatilho de recorrência.

  Importante

  Se você usar a frequência Dia, Semana ou Mês e especificar uma data e hora futuras, certifique-se de configurar a recorrência com antecedência:

  • Dia: Configure a recorrência diária com pelo menos 24 horas de antecedência.

  • Semana: Configure a recorrência semanal com pelo menos 7 dias de antecedência.

  • Mês: configure a recorrência mensal com pelo menos um mês de antecedência.

  Caso contrário, o fluxo de trabalho pode ignorar a primeira recorrência.

  Se uma recorrência não especificar uma data e hora de início específicas, a primeira recorrência será executada imediatamente quando você salvar ou implantar o aplicativo lógico, apesar da configuração de recorrência do gatilho. Para evitar esse comportamento, forneça uma data e hora de início para quando você deseja que a primeira recorrência seja executada.

  Se uma recorrência não especificar outras opções avançadas de agendamento, como horários específicos para executar recorrências futuras, essas recorrências serão baseadas no último tempo de execução. Como resultado, os horários de início dessas recorrências podem se desviar devido a fatores como latência durante chamadas de armazenamento. Para garantir que seu fluxo de trabalho não perca uma recorrência, especialmente quando a frequência é em dias ou mais, tente estas opções:

  • Forneça uma data e hora de início para a recorrência, além das horas específicas em que executar as recorrências subsequentes usando as propriedades denominadas Nessas horas e Nesses minutos, que estão disponíveis apenas para as frequências Dia e Semana .

  • Use o gatilho Janela deslizante, em vez do gatilho Recorrência.

  Para obter mais informações, consulte Criar, agendar e executar tarefas e fluxos de trabalho recorrentes com o gatilho de recorrência.

• Janela deslizante: executa seu fluxo de trabalho em intervalos de tempo regulares que manipulam dados em partes contínuas. Se o gatilho perder recorrências, por exemplo, devido a interrupções ou fluxos de trabalho desativados, o gatilho da Janela Deslizante voltará e processará as recorrências perdidas.

  Você pode especificar uma data e hora de início, fuso horário e uma duração para atrasar cada recorrência em seu fluxo de trabalho. Esse gatilho não suporta agendas avançadas, por exemplo, horas específicas do dia, minutos da hora e dias da semana. Para obter mais informações, consulte Criar, agendar e executar tarefas e fluxos de trabalho recorrentes com o gatilho Janela Deslizante.

Agendar ações

Após qualquer ação no fluxo de trabalho do aplicativo lógico, você pode usar as ações Atrasar e Atrasar até para fazer com que o fluxo de trabalho aguarde antes que a próxima ação seja executada.

• Atraso: aguarde para executar a próxima ação para o número especificado de unidades de tempo, como segundos, minutos, horas, dias, semanas ou meses. Para obter mais informações, consulte Atrasar a próxima ação em fluxos de trabalho.

• Adiar até: Aguarde para executar a próxima ação até a data e hora especificadas. Para obter mais informações, consulte Atrasar a próxima ação em fluxos de trabalho.

Padrões para data e hora de início

Aqui estão alguns padrões que mostram como você pode controlar a recorrência com a data e hora de início e como os Aplicativos Lógicos do Azure executam essas recorrências:

Exemplo de hora de início passada e recorrência, mas sem agendamento

Suponha que a data e hora atuais sejam 8 de setembro de 2017 às 13:00. Você especifica a data e a hora de início como 7 de setembro de 2017 às 14:00, que está no passado, e uma recorrência que é executada a cada dois dias.

Para o gatilho de Recorrência , o mecanismo de Aplicativos Lógicos do Azure calcula os tempos de execução com base na hora de início, descarta os tempos de execução passados, usa a próxima hora de início futura para a primeira execução e calcula execuções futuras com base no último tempo de execução.

Veja como fica essa recorrência:

Assim, não importa o quão longe no passado você especifique a hora de início, por exemplo, 2017-09-05 às 14:00 ou 2017-09-01 às 14:00, sua primeira corrida sempre usa a próxima hora de início futura.

Para o gatilho Janela Deslizante, o mecanismo Aplicativos Lógicos calcula os tempos de execução com base na hora de início, honra os tempos de execução anteriores, usa a hora de início para a primeira execução e calcula execuções futuras com base na hora de início.

Veja como fica essa recorrência:

Assim, não importa o quão longe no passado você especifique a hora de início, por exemplo, 2017-09-05 às 14:00 ou 2017-09-01 às 14:00, sua primeira execução sempre usa a hora de início especificada.

Comportamento de recorrência

Os gatilhos internos recorrentes, como o gatilho Recorrência, são executados direta e nativamente no tempo de execução dos Aplicativos Lógicos do Azure. Esses gatilhos diferem dos gatilhos de conector gerenciado baseados em conexão recorrentes, nos quais você precisa criar uma conexão primeiro, como o gatilho de conector gerenciado do Outlook do Office 365.

Para ambos os tipos de gatilhos, se uma recorrência não especificar uma data e hora de início, a primeira recorrência será executada imediatamente quando você salvar ou implantar o recurso do aplicativo lógico, apesar da configuração de recorrência do gatilho. Para evitar esse comportamento, forneça uma data e hora de início para quando você deseja que a primeira recorrência seja executada.

Recorrência para gatilhos internos

Os gatilhos internos recorrentes seguem a programação que você definiu, incluindo qualquer fuso horário especificado. No entanto, se uma recorrência não especificar outras opções avançadas de agendamento, como horários específicos para executar recorrências futuras, essas recorrências serão baseadas na última execução do gatilho. Como resultado, os horários de início dessas recorrências podem se desviar devido a fatores como latência durante chamadas de armazenamento. As opções avançadas de agendamento, como Nessas horas e Nestes dias para a recorrência Semanal , estão disponíveis e funcionam apenas com gatilhos de sondagem internos, como os gatilhos de Recorrência e Janela Deslizante , que são executados direta e nativamente no tempo de execução dos Aplicativos Lógicos do Azure.

Para obter mais informações, consulte a seguinte documentação:

• Acionar a recorrência para o horário de verão e o horário padrão
• Solucionar problemas de recorrência

Recorrência para gatilhos gerenciados

Para gatilhos gerenciados recorrentes, como o Office 365 Outlook, Outlook.com e assim por diante, o agendamento não é o único driver que controla a execução. O fuso horário determina apenas a hora de início inicial. As execuções subsequentes dependem do cronograma de recorrência, da última execução do gatilho e de outros fatores que podem fazer com que os tempos de execução se desviem ou produzam um comportamento inesperado, por exemplo:

• Se o gatilho acessa um servidor que tem mais dados, que o gatilho imediatamente tenta buscar.
• Quaisquer falhas ou novas tentativas que o gatilho incorra.
• Latência durante chamadas de armazenamento.
• Não manter a programação especificada quando o horário de verão (DST) começa e termina.
• Outros fatores que podem afetar quando o próximo tempo de execução acontece.

Opções avançadas de agendamento, como Nessas horas e Nestes dias para a recorrência Semanal , não estão disponíveis ou não têm suporte para conectores que são gerenciados, hospedados e executados pela Microsoft no Azure. Esses gatilhos de sondagem calculam a próxima recorrência usando apenas os valores Intervalo e Frequência .

Para obter mais informações, consulte a seguinte documentação:

• Acionar a recorrência para o horário de verão e o horário padrão
• Acione o deslocamento e o desvio de recorrência durante o horário de verão e o horário padrão
• Solucionar problemas de recorrência

Acionar a recorrência para o horário de verão e o horário padrão

Para agendar trabalhos, os Aplicativos Lógicos do Azure colocam a mensagem para processamento na fila e especificam quando essa mensagem fica disponível, com base na hora UTC quando o último trabalho foi executado e na hora UTC quando o próximo trabalho está agendado para ser executado. Se você especificar uma hora de início com sua recorrência, certifique-se de selecionar um fuso horário para que o fluxo de trabalho do aplicativo lógico seja executado na hora de início especificada. Dessa forma, a hora UTC do seu aplicativo lógico também muda para combater a mudança de hora sazonal. Os gatilhos recorrentes honram a agenda que você definiu, incluindo qualquer fuso horário que você especificar.

Se você não selecionar um fuso horário, os eventos de horário de verão (DST) poderão afetar quando os gatilhos forem executados. Por exemplo, a hora de início muda uma hora para a frente quando o horário de verão começa e uma hora para trás quando o horário de verão termina.

Acione o deslocamento e o desvio de recorrência durante o horário de verão e o horário padrão

Para gatilhos recorrentes baseados em conexão, o agendamento de recorrência não é o único driver que controla a execução. O fuso horário determina apenas a hora de início inicial. As execuções subsequentes dependem do cronograma de recorrência, da última execução do gatilho e de outros fatores que podem fazer com que os tempos de execução se desviem ou produzam um comportamento inesperado, por exemplo:

• Falha em manter o horário especificado quando o horário de verão (DST) começa e termina.
• Outros fatores que podem afetar quando o próximo tempo de execução acontece.
• Latência durante chamadas de armazenamento.
• Se o gatilho acessa um servidor que tem mais dados, que o gatilho imediatamente tenta buscar.
• Quaisquer falhas ou novas tentativas que o gatilho incorra.

Para garantir que o tempo de recorrência não mude quando o horário de verão entrar em vigor, ajuste manualmente a recorrência. Dessa forma, seu fluxo de trabalho continua a ser executado na hora de início esperada ou especificada. Caso contrário, a hora de início muda uma hora para a frente quando o horário de verão começa e uma hora para trás quando o horário de verão termina.

Por exemplo, suponha que você tenha dois aplicativos lógicos que são executados diariamente. Um aplicativo lógico é executado à 1h30 no horário local, enquanto o outro é executado uma hora depois, às 2h30 no horário local. O que acontece com os horários de início desses aplicativos quando o horário de verão começa e termina?

• Os gatilhos são acionados quando o tempo muda uma hora para a frente?

• Os gatilhos são executados duas vezes quando o tempo muda uma hora para trás?

Se esses aplicativos lógicos usarem a zona UTC-6:00 Central Time (US & Canada), esta simulação mostra como os horários UTC mudaram em 2019 para combater as alterações do horário de verão, movendo-se uma hora para trás ou para frente, conforme necessário, para que os aplicativos continuassem sendo executados nos horários locais esperados sem execuções ignoradas ou duplicadas.

• 03/10/2019: O horário de verão começa às 02:00, mudando o tempo uma hora para a frente

  Para compensar após o início do horário de verão, a hora UTC muda uma hora para trás para que seu aplicativo lógico continue em execução no mesmo horário local:

  • Aplicativo lógico #1

    Date	Hora (local)	Hora (UTC)	Notas
    03/09/2019	01:30:00	07:30:00	UTC antes do dia em que o horário de verão entra em vigor.
    03/10/2019	01:30:00	07:30:00	UTC é o mesmo porque o horário de verão não entrou em vigor.
    03/11/2019	01:30:00	06:30:00	O UTC mudou uma hora para trás depois que o horário de verão entrou em vigor.

  • Aplicativo lógico #2

    Date	Hora (local)	Hora (UTC)	Notas
    03/09/2019	02:30:00	08:30:00	UTC antes do dia em que o horário de verão entra em vigor.
    03/10/2019	03:30:00*	08:30:00	O horário de verão já está em vigor, então a hora local avançou uma hora porque o fuso horário UTC-6:00 muda para UTC-5:00. Para obter mais informações, consulte Gatilhos que começam entre 2h00 e 3h00.
    03/11/2019	02:30:00	07:30:00	O UTC mudou uma hora para trás depois que o horário de verão entrou em vigor.

• 11/03/2019: O horário de verão termina às 02:00 e muda o tempo uma hora para trás

  Para compensar, a hora UTC muda uma hora para a frente para que seu aplicativo lógico continue em execução no mesmo horário local:

  • Aplicativo lógico #1

    Date	Hora (local)	Hora (UTC)	Notas
    11/02/2019	01:30:00	06:30:00
    11/03/2019	01:30:00	06:30:00
    11/04/2019	01:30:00	07:30:00

  • Aplicativo lógico #2

    Date	Hora (local)	Hora (UTC)	Notas
    11/02/2019	02:30:00	07:30:00
    11/03/2019	02:30:00	08:30:00
    11/04/2019	02:30:00	08:30:00

Executar apenas uma vez

Para executar seu fluxo de trabalho apenas uma vez no futuro, você pode usar o modelo de fluxo de trabalho Agendador: Executar uma vez trabalhos.

Executar uma vez no último dia do mês

Para executar o gatilho de Recorrência apenas uma vez no último dia do mês, consulte Executar uma vez no último dia do mês.

Exemplo de recorrências

Aqui estão vários exemplos de recorrências que você pode configurar para os gatilhos que suportam as opções:

Solucionar problemas de recorrência

Para garantir que seu fluxo de trabalho seja executado na hora de início especificada e não perca uma recorrência, especialmente quando a frequência é em dias ou mais, tente as seguintes soluções:

• Quando o horário de verão entrar em vigor, ajuste manualmente a recorrência para que seu fluxo de trabalho continue a ser executado no momento esperado. Caso contrário, a hora de início muda uma hora para a frente quando o horário de verão começa e uma hora para trás quando o horário de verão termina. Para obter mais informações e exemplos, consulte Recorrência para o horário de verão e o horário padrão.

• Se você estiver usando um gatilho de Recorrência , especifique um fuso horário, uma data de início e uma hora de início. Além disso, configure horários específicos para executar recorrências subsequentes nas propriedades Nessas horas e Nesses minutos, que estão disponíveis apenas para as frequências Dia e Semana . No entanto, algumas janelas de tempo ainda podem causar problemas quando o tempo muda.

• Considere usar um gatilho de janela deslizante em vez de um gatilho de recorrência para evitar recorrências perdidas.

Próximos passos

• Crie, agende e execute tarefas e fluxos de trabalho recorrentes com o gatilho Recorrência
• Crie, agende e execute tarefas e fluxos de trabalho recorrentes com o gatilho Janela Deslizante
• Pausar fluxos de trabalho com ações de atraso