Referência de sintaxe de programação do cron

Nesta seção, descrevemos a sintaxe para definição de execuções de fluxo programadas usando o cron no Cloud Dataprep by TRIFACTA®. Normalmente, esse método é usado para execuções repetidas do fluxo a fim de escrever dados cíclicos em Wrangle com a finalidade de consumo downstream.

  • Os proprietários de fluxo podem definir execuções programadas de fluxos na página "Flow View".
  • Colaboradores podem fazer a revisão, mas não podem editar as programações.
  • Consulte Página "Flow View".

Visão geral do cron

O Cloud Dataprep by TRIFACTA® permite que você use o cron, uma sintaxe usada amplamente, para especificar horários recorrentes em intervalos regulares. O cron pode ser usado para especificar programações por minuto ou anuais com intervalos arbitrários entre elas.

Sintaxe do cron

Um cron programado é definido como uma string de valores separados por espaços. O exemplo de cron a seguir define uma programação que será ativada às 11h30 em 1º de fevereiro:

minutohoradia do mêsmêsdia da semana
302312*

Quando todos os valores são correspondidos, o cron job é ativado.

OBSERVAÇÃO: a especificação de segundos não é compatível.

Caracteres curinga:

Na expressão cron acima, o caractere curinga * pode ser usado para a correspondência com qualquer valor aceito, o que significa que o tipo de valor cron não é um fator na determinação dessa programação. Como o caractere curinga é aplicado ao valor do dia da semana, a programação pode ser acionada em qualquer dia da semana.

OBSERVAÇÃO: é necessário usar o caractere * nos campos dia da semana ou dia do mês. A especificação dos dois campos na mesma expressão cron não é aceita.

Legenda:

Com exceção do campo final (ano), todos os campos são necessários na expressão cron. Os caracteres especiais são descritos na tabela a seguir.

ValorTipoDescriçãoCaracteres especiais aceitos
30minuto0-59, - * /
23hora0-23, - * /
1dia do mês1-31, - * / L W
2mês1-12, - * /
*dia da semana

0-6 ou Sun-Sat

0, Sun, SUN = domingo

1, Mon, MON = segunda-feira

6, Sat, SAT = sábado

, - * / L #
*ano(Opcional) Você pode especificar as configurações do ano, se necessário. O padrão é *., - * /

Caracteres especiais

Você pode usar os seguintes caracteres especiais nas suas expressões cron.

CaractereDescrição
*("todos os valores"): caractere curinga que corresponde a todos os valores possíveis no campo. Por exemplo, se você quiser que o acionador dispare a cada minuto das 22h, o caractere de minuto na expressão é *. Vejamos um exemplo a seguir.
-Especifique um intervalo de valores. Por exemplo, você pode usar 1-5 no campo de dia da semana para combinar os dias úteis da semana (de segunda a sexta-feira). Vejamos um exemplo a seguir.
,Especifique um conjunto distinto de valores. Por exemplo, uma entrada de 1,10,20,30 para o campo do dia do mês é acionada nos dias 1, 10, 20 e 30 (se possível) do mês.
/Especifique incrementos do campo nas unidades dele. Por exemplo, 5/20 no campo de minutos corresponde aos 5, 25 e 45 minutos de cada hora.
L

O último valor aceito no intervalo é aceito nos seguintes campos:

  • Dia do mês: especifica o último dia do mês para o valor do mês selecionado atualmente.
    • Em janeiro, esse valor corresponde a 31.
    • Em fevereiro, esse valor corresponde a 28 para anos que não são bissextos.
    • Em abril, esse valor corresponde a 30.
  • Dia da semana:
    • Por si só, especifica o último dia da semana, que coincide com 6 (sábado).
    • Quando usado com outro valor, especifica o último valor de correspondência para o mês. Por exemplo, 3L é a última quarta-feira do mês.
W

Especifica o dia da semana correspondente mais próximo. Por exemplo, uma entrada 22W no campo de dia do mês corresponde ao dia de semana mais próximo do dia 22 do mês. Se o 22º dia é um sábado, o cron job faz a correspondência com o dia 24, a segunda-feira seguinte.

Dica: LW pode ser usado no campo dia do mês para coincidir com o último dia da semana do mês.

#

Especifica o nono dia do mês. Exemplos para o campo de dia da semana:

  • 3#4: quarta terça-feira do mês
  • 5#2: segunda quinta-feira do mês


Exemplos

Veja alguns exemplos de programações cron a seguir.

Por hora

É acionada no minuto 15 de cada hora:

15 * * * *

Diariamente

É acionada todos os dias às 22h:

0 22 * * *

É acionada a cada minuto das 22h, todos os dias:

* 22 * * *

Semanal

É acionada todas as terças-feiras às 3h:

0 3 * * 2

Dias da semana

É acionada todo dia da semana às 8h:

0 20 * * 1-5

Observe que a programação acima é executada às 22h de segunda-feira e a cada noite da semana no mesmo horário.

Para atualizar o fluxo para cada manhã da semana, você pode optar por iniciar os horários no domingo, em que o valor do dia da semana começa com 0 e termina com 4.

Mensal

É acionado no primeiro dia de cada mês às 2h30:

30 2 1 * *

Anualmente

É acionado à meia-noite de 1º de janeiro de cada ano:

0 0 1 1 * *


Outros exemplos

ExpressãoSignificado

0 12 * * *
Disparar às 12h (meio-dia) todos os dias

15 10 * * *
Disparar às 10h15 todos os dias

15 10 * * *
Disparar às 10h15 todos os dias

15 10 * * * *
Disparar às 10h15 todos os dias

15 10 * * * 2017
Disparar às 10h15 todos os dias durante o ano de 2017

* 14 * * *
Disparar a cada minuto a partir das 14h e terminar às 14h59, todos os dias

0/5 14 * * *
Disparar a cada 5 minutos a partir das 14h e terminar às 14h55, todos os dias

0/5 14,18 * * *
Disparar a cada 5 minutos a partir das 14h e terminar às 14h55, E disparar a cada 5 minutos a partir das 18h e terminar às 18h55, todos os dias

0-5 14 * * *
Disparar a cada minuto a partir das 14h e terminar às 14h05, todos os dias

10,44 14 * 3 WED
Disparar às 14h10 e às 14h44 todas as quartas-feiras no mês de março

15 10 * * MON-FRI
Disparar às 10h15 todas as segundas, terças, quartas, quintas e sextas-feiras

15 10 15 * *
Disparar às 10h15 no 15º dia de cada mês

15 10 L * *
Disparar às 10h15 no último dia de cada mês

15 10 L-2 * *
Disparar às 10h15 no penúltimo dia de cada mês

15 10 * * 6L
Disparar às 10h15 na última sexta-feira de cada mês

15 10 * * 6L 2017-2019
Disparar às 10h15 em todas as últimas sextas-feiras de cada mês durante os anos de 2017, 2018 e 2019

15 10 * * 6#3
Disparar às 10h15 da terceira sexta-feira de cada mês

0 12 1/5 * *
Disparar às 12h (meio-dia) a cada 5 dias todos os meses, a partir do primeiro dia do mês

11 11 11 11 *
Disparar todo 11 de novembro às 11h11

Expressões cron inválidas

ExpressãoSignificadoMotivo

15 10 * * * 2001
Disparar às 10h15 todos os dias durante o ano de 2001Esta expressão cron é inválida porque não gerará eventos no futuro.

* * *

-

A expressão cron deve conter seis ou sete campos.
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Google Cloud Dataprep
Precisa de ajuda? Acesse nossa página de suporte.