Cron-Planungs-Syntaxreferenz
In diesem Abschnitt wird die Syntax zum Definieren geplanter Ausführungen mit Cron in Alteryx Analytics Cloud (AAC) beschrieben. In der Regel wird diese Methode für wiederholte Zeitpläne verwendet.
Anmerkung
Zeitzoneneinstellungen, die auf der Seite
AAC definiert sind, auf der Sie den Cron-Zeitplan angeben, werden mit dem Zeitplan verwendet. Um die UTC-Zeitzone zu verwenden, wählen Sie
UTC
in der Dropdown-Liste aus.
Überblick über Cron
AAC ermöglicht die Verwendung von Cron, einer weit verbreiteten Syntax, zur Angabe von Zeiten, die in regelmäßigen Abständen wiederholt werden. Sie können Cron einsetzen, um Zeitpläne pro Minute oder pro Jahr und für beliebige Intervalle dazwischen anzugeben.
Cron-Syntax
Ein geplanter Cron ist als durch Leerzeichen getrennte Zeichenfolge von Werten definiert. Das folgende Cron-Beispiel definiert einen Zeitplan, der am 1. Februar um 23:30:00 Uhr ausgelöst wird:
Minute | Stunde | Tag des Monats | Monat | Wochentag |
---|---|---|---|---|
30 | 23 | 1 | 2 | * |
Wenn alle Werte zutreffen, wird der Cron-Auftrag ausgelöst.
Anmerkung
Die Angabe von Sekunden wird nicht unterstützt.
Platzhalter:
Im obigen Cron-Ausdruck kann der Platzhalter „*“ für jeden akzeptierten Wert verwendet werden. Dies bedeutet, dass der Cron-Wertetyp kein Faktor bei der Festlegung dieses Zeitplans ist. Da der Platzhalter auf den Wert „Wochentag“ angewendet wird, kann der Zeitplan an jedem Wochentag ausgelöst werden.
Anmerkung
Sie müssen das Zeichen
*
entweder im Feld „Wochentag“ oder im Feld „Tag des Monats“ verwenden. Die Angabe beider Felder im selben Cron-Ausdruck wird nicht unterstützt.
Legende:
Mit Ausnahme des letzten Feldes (Jahr) sind alle Felder im Cron-Ausdruck Pflichtfelder. Sonderzeichen werden unten in der Tabelle beschrieben.
Wert | Typ | Beschreibung | Unterstützte Sonderzeichen |
---|---|---|---|
30 | Minute | 0-59 | , - * / |
23 | Stunde | 0-23 | , - * / |
1 | Tag des Monats | 1-31 | , - * / L W |
2 | Monat | 1-12 | , - * / |
* | Wochentag | 0–6 oder So–Sa 0, So, SO = Sonntag 1, Mo, MO = Montag ... 6, Sa, SA = Samstag | , - * / L # |
* | Jahr | (Optional) Sie können bei Bedarf Einstellungen für das Jahr festlegen. Der Standardwert ist „*“. | , - * / |
Sonderzeichen
Sie können die folgenden Sonderzeichen in Ihren Cron-Ausdrücken verwenden.
Zeichen | Beschreibung |
---|---|
* | (
„Alle Werte“
) – Platzhalter für alle möglichen Werte im Feld. Wenn Sie beispielsweise möchten, dass das Auslösen in jeder Minute der Stunde nach 22:00 Uhr stattfindet, ist das Minutenzeichen im Ausdruck
|
- | Geben Sie einen Wertebereich an. Beispiel: Sie können
|
, | Geben Sie eine Reihe von einzelnen Werten an. Beispiel: Ein Eintrag von
|
/ | Geben Sie Inkremente des Feldes in den Einheiten des Feldes an. Beispiel:
|
L | Der letzte akzeptierte Wert im Bereich kann in den folgenden Feldern verwendet werden:
|
W | Gibt den nächstgelegenen entsprechenden Werktag an. Beispiel: Ein Eintrag von
Tipp
|
# | Gibt den n-ten Tag des Monats an. Beispiele für das Feld „Wochentag“:
|
Beispiele
Nachfolgend finden Sie einige Beispiele für Cron-Zeitpläne.
Stündlich
Wird jede Stunde in Minute 15 ausgeführt:
15 * * * *
Täglich
Wird täglich um 22:00 Uhr ausgeführt:
0 22 * * *
Wird täglich jede Minute der Stunde nach 22:00 Uhr ausgeführt:
* 22 * * *
Wöchentlich
Wird jeden Dienstag um 03:00 Uhr ausgeführt:
0 3 * * 2
An Werktagen
Wird an jedem Werktag um 20:00 Uhr ausgeführt:
0 20 * * 1-5
Beachten Sie, dass der oben genannte Zeitplan am Montagabend um 20:00 Uhr und an jedem Abend der Woche zu diesem Zeitpunkt ausgeführt wird.
Wenn es um Aktivitäten am Vormittag jedes Werktags geht, können Sie die Zeitpläne am Sonntag starten, wobei der Wochentagswert mit 0 beginnt und mit 4 endet.
Monatlich
Wird am ersten Tag jedes Monats um 02:30 Uhr ausgeführt:
30 2 1 * *
Wird am nächsten Werktag (W) zum 25. des Monats um 15:30 Uhr ausgeführt:
30 15 25W * *
Wenn der 25. ein Samstag ist, wird das oben genannte am Freitag, den 24. ausgelöst.
Wenn der 25. ein Sonntag ist, wird das oben genannte am Montag, den 26. ausgelöst.
Jährlich
Wird jedes Jahr am 1. Januar um Mitternacht ausgeführt:
0 0 1 1 * *
Weitere Beispiele
Ausdruck | Bedeutung |
---|---|
0 12 * * * | Wird jeden Tag um 12:00 Uhr (mittags) ausgelöst |
15 10 * * * | Wird jeden Tag um 10:15 Uhr ausgelöst |
15 10 * * * | Wird jeden Tag um 10:15 Uhr ausgelöst |
15 10 * * * * | Wird jeden Tag um 10:15 Uhr ausgelöst |
15 10 * * * 2017 | Wird im Jahr 2017 jeden Tag um 10:15 Uhr ausgelöst |
* 14 * * * | Wird täglich jede Minute von 14:00 Uhr bis 14:59 Uhr ausgelöst |
0/5 14 * * * | Wird täglich alle 5 Minuten von 14:00 Uhr bis 14:55 Uhr ausgelöst |
0/5 14,18 * * * | Wird täglich alle 5 Minuten von 14:00 Uhr bis 14:55 Uhr UND alle 5 Minuten von 18:00 Uhr bis 18:55 Uhr ausgelöst |
0-5 14 * * * | Wird täglich jede Minute von 14:00 Uhr bis 14:05 Uhr ausgelöst |
10,44 14 * 3 WED | Wird jeden Mittwoch im März um 14:10 Uhr und um 14:44 Uhr ausgelöst |
15 10 * * MON-FRI | Wird jeden Montag, Dienstag, Mittwoch, Donnerstag und Freitag um 10:15 Uhr ausgelöst |
15 10 15 * * | Wird am 15. jedes Monats um 10:15 Uhr ausgelöst |
15 10 L * * | Wird am letzten Tag jedes Monats um 10:15 Uhr ausgelöst |
15 10 L-2 * * | Wird am zweitletzten Tag jedes Monats um 10:15 Uhr ausgelöst |
15 10 * * 5L | Wird am letzten Freitag jedes Monats um 10:15 Uhr ausgelöst |
15 10 * * 5L 2017-2019 | Wird in den Jahren 2017, 2018 und 2019 am letzten Freitag jedes Monats um 10:15 Uhr ausgelöst |
15 10 * * 5#3 | Wird am dritten Freitag jedes Monats um 10:15 Uhr ausgelöst |
0 12 1/5 * * | Wird jeden Monat alle 5 Tage ab dem ersten Tag des Monats um 12:00 Uhr (mittags) ausgelöst |
11 11 11 11 * | Wird jeden 11. November um 11:11 Uhr ausgelöst. |
Nicht unterstützte Cron-Ausdrücke
Anmerkung
AAC unterstützt nicht das Mischen der Sonderzeichen
/
und
-
in denselben Ausdrücken.
Anstatt Bereiche in der Cron-Syntax auszudrücken, können Sie alle möglichen Optionen referenzieren.
Ungültiger Ausdruck | Gültiger Ausdruck |
---|---|
0 23 * 1-11/2 * * | 0 23 * 2,4,6,8,10 * * |
Ungültige Cron-Ausdrücke
Ausdruck | Bedeutung | Ursache |
---|---|---|
15 10 * * * 2001 | Wird im Jahr 2001 jeden Tag um 10:15 Uhr ausgelöst | Dieser Cron-Ausdruck ist ungültig, weil er keine Ereignisse in der Zukunft generiert. |
* * * | - | Der Cron-Ausdruck muss sechs oder sieben Felder enthalten. |