Riferimento per la sintassi di pianificazione cron
In questa sezione viene descritta la sintassi per definire le esecuzioni pianificate con cron in Alteryx Analytics Cloud (AAC). In genere, questo metodo viene utilizzato per le pianificazioni ripetute.
Nota
Le impostazioni del fuso orario definite nella pagina
AAC in cui viene specificata la pianificazione cron vengono utilizzate con la stessa. Per utilizzare il fuso orario UTC, seleziona
UTC
nel menu a discesa.
Panoramica di cron
AAC consente di utilizzare cron, una sintassi ampiamente utilizzata, per specificare gli orari che ricorrono a intervalli regolari. Puoi utilizzare cron per specificare le pianificazioni al minuto o su base annuale e gli intervalli arbitrari intermedi.
Sintassi cron
Una pianificazione cron è definita come una stringa di valori separati da spazi. Il seguente esempio di cron definisce una pianificazione da attivare alle 23:30:00 del 1° febbraio:
minuto | ora | giorno del mese | mese | giorno della settimana |
---|---|---|---|---|
30 | 23 | 1 | 2 | * |
Quando tutti i valori sono abbinati, il processo cron viene attivato.
Nota
La specifica dei secondi non è supportata.
Caratteri jolly:
Nell'espressione cron precedente, il carattere jolly * può essere utilizzato per abbinare qualsiasi valore accettato, il che significa che il tipo di valore cron non determina questa pianificazione. Poiché il carattere jolly viene applicato al valore del giorno della settimana, la pianificazione può essere attivata in qualsiasi giorno della settimana.
Nota
È necessario utilizzare il carattere
*
nei campi del giorno della settimana o del giorno del mese. La specifica di entrambi i campi nella stessa espressione cron non è supportata.
Legenda:
Nell'espressione cron tutti i campi sono obbligatori, tranne quello finale (anno). I caratteri speciali sono descritti sotto la tabella.
Valore | Tipo | Descrizione | Caratteri speciali supportati |
---|---|---|---|
30 | minuto | 0-59 | , - * / |
23 | ora | 0-23 | , - * / |
1 | giorno del mese | 1-31 | , - * / L W |
2 | mese | 1-12 | , - * / |
* | giorno della settimana | 0 - 6 o Dom - Sab 0, Dom, DOM = Domenica 1, Lun, LUN = Lunedì ... 6, Sab, SAB = Sabato | , - * / L # |
* | anno | (Facoltativo) Se necessario, è possibile specificare le impostazioni dell'anno. Il valore predefinito è * . | , - * / |
Caratteri speciali
Puoi utilizzare i seguenti caratteri speciali nelle espressioni cron.
Carattere | Descrizione |
---|---|
* | (
"tutti i valori"
) - Carattere jolly abbinabile a tutti i valori possibili nel campo. Ad esempio, se desideri che un'operazione venga attivata ogni minuto tra le 22:00 e le 23:00, i minuti nell'espressione sono rappresentati dal carattere
|
- | Specifica un intervallo di valori. Ad esempio, è possibile utilizzare
|
, | Specifica un set di valori discreto. Ad esempio, se si specifica
|
/ | Specifica gli incrementi del campo nelle unità del campo. Ad esempio,
|
L | L'ultimo valore accettato nell'intervallo è accettato nei seguenti campi:
|
W | Specifica il giorno lavorativo corrispondente più vicino. Ad esempio,
Suggerimento
|
# | Specifica il giorno del mese. Esempi per il campo del giorno della settimana:
|
Esempi
Di seguito sono riportati alcuni esempi di pianificazioni cron.
Orario
Esecuzione al minuto 15 di ogni ora:
15 * * * *
Giornalmente
Esecuzione ogni giorno alle 22:00:
0 22 * * *
Esecuzione ogni minuto tra le 22:00 e le 23:00 ogni giorno:
* 22 * * *
Settimanalmente
Esecuzione ogni martedì alle 3:00:
0 3 * * 2
Giorni lavorativi
Esecuzione ogni giorno lavorativo alle 20:00:
0 20 * * 1-5
La pianificazione precedente viene eseguita lunedì alle 20:00 e ogni sera della settimana a tale ora.
Per ogni mattina dei giorni lavorativi, puoi scegliere di avviare le pianificazioni la domenica, in cui il valore del giorno lavorativo inizia con 0 e termina con 4.
Mensile
Esecuzione il primo giorno di ogni mese alle 2:30:
30 2 1 * *
Esecuzione alle 15:30 del giorno lavorativo più vicino (W) al 25 del mese:
30 15 25W * *
Se il 25 è un sabato, l'esecuzione avviene venerdì 24.
Se il 25 è una domenica, l'esecuzione avviene lunedì 26.
Annuale
Esecuzione ogni anno a mezzanotte del 1° gennaio:
0 0 1 1 * *
Altri esempi
Espressione | Significato |
---|---|
0 12 * * * | Attivazione alle 12:00 (mezzogiorno) tutti i giorni |
15 10 * * * | Attivazione alle 10:15 tutti i giorni |
15 10 * * * | Attivazione alle 10:15 tutti i giorni |
15 10 * * * * | Attivazione alle 10:15 tutti i giorni |
15 10 * * * 2017 | Attivazione alle 10:15 tutti i giorni nel 2017 |
* 14 * * * | Attivazione ogni minuto dalle 14:00 fino alle 14:59, tutti i giorni |
0/5 14 * * * | Attivazione ogni 5 minuti dalle 14:00 fino alle 14:55, tutti i giorni |
0/5 14,18 * * * | Attivazione ogni 5 minuti dalle 14:00 alle 14:55 E ogni 5 minuti dalle 18:00 alle 18:55, tutti i giorni |
0-5 14 * * * | Attivazione ogni minuto dalle 14:00 fino alle 14:05, tutti i giorni |
10,44 14 * 3 WED | Attivazione alle 14:10 e alle 14:44 ogni mercoledì nel mese di marzo. |
15 10 * * MON-FRI | Attivazione alle 10:15 ogni lunedì, martedì, mercoledì, giovedì e venerdì |
15 10 15 * * | Attivazione alle 10:15 del 15 di ogni mese |
15 10 L * * | Attivazione alle 10:15 dell'ultimo giorno di ogni mese |
15 10 L-2 * * | Attivazione alle 10:15 del penultimo giorno di ogni mese |
15 10 * * 5L | Attivazione alle 10:15 dell'ultimo venerdì di ogni mese |
15 10 * * 5L 2017-2019 | Attivazione alle 10:15 ogni ultimo venerdì di ogni mese nel 2017, 2018 e 2019 |
15 10 * * 5#3 | Attivazione alle 10:15 del terzo venerdì di ogni mese |
0 12 1/5 * * | Attivazione alle 12:00 (mezzogiorno) ogni 5 giorni ogni mese, a partire dal primo giorno del mese. |
11 11 11 11 * | Attivazione ogni 11 novembre alle 11:11. |
Espressioni cron non supportate
Nota
AAC non supporta la combinazione dei caratteri speciali
/
e
-
nelle stesse espressioni.
Invece di esprimere gli intervalli nella sintassi cron, è possibile fare riferimento a tutte le opzioni possibili.
Espressione non valida | Espressione valida |
---|---|
0 23 * 1-11/2 * * | 0 23 * 2,4,6,8,10 * * |
Espressioni cron non valide
Espressione | Significato | Motivo |
---|---|---|
15 10 * * * 2001 | Attivazione alle 10:15 tutti i giorni nel 2001 | Questa espressione cron non è valida perché non genererà alcun evento in futuro. |
* * * | - | L'espressione cron deve contenere 6 o 7 campi. |