Référence de syntaxe des planifications cron
Cette section décrit la syntaxe permettant de définir des exécutions planifiées à l'aide de cron dans Alteryx Analytics Cloud (AAC). En général, cette méthode est utilisée pour les planifications à occurrence répétée.
Note
Les paramètres de fuseau horaire définis sur la page
AAC où vous spécifiez votre planification cron sont utilisés avec la planification. Pour utiliser le fuseau horaire UTC, sélectionnez
UTC
dans la liste déroulante.
Présentation de cron
AAC vous permet d'utiliser cron, une syntaxe largement utilisée pour spécifier les périodes qui se répètent à intervalles réguliers. Vous pouvez utiliser cron pour spécifier des planifications par minute ou par année et des intervalles arbitraires entre les deux.
Syntaxe cron
Un cron planifié est défini sous la forme d'une chaîne de valeurs séparées par des espaces. L'exemple cron suivant définit une planification qui se déclenchera à 23 h 30 le 1er février :
minute | heure | jour du mois | mois | jour de la semaine |
---|---|---|---|---|
30 | 23 | 1 | 2 | * |
Lorsque toutes les valeurs correspondent, la tâche cron est déclenchée.
Note
La spécification des secondes n'est pas prise en charge.
Caractères génériques :
Dans l'expression cron ci-dessus, le caractère générique * peut être utilisé pour correspondre à n'importe quelle valeur acceptée, ce qui signifie que le type de valeur cron n'est pas un facteur de détermination de cette planification. Comme le caractère générique est appliqué à la valeur du jour de la semaine, la planification peut se déclencher n'importe quel jour de la semaine.
Note
Vous devez utiliser le caractère
*
dans les champs jour de la semaine ou jour du mois. La spécification des deux champs dans la même expression cron n'est pas prise en charge.
Légende :
À l'exception du dernier champ (année), tous les champs sont obligatoires dans l'expression cron. Les caractères spéciaux sont décrits sous le tableau.
Valeur | Type | Description | Caractères spéciaux pris en charge |
---|---|---|---|
30 | minute | 0-59 | , - * / |
23 | heure | 0-23 | , - * / |
1 | jour du mois | 1-31 | , - * / L W |
2 | mois | 1-12 | , - * / |
* | jour de la semaine | 0 - 6 ou Sun- Sat 0, Sun, SUN = Dimanche 1, Mon, MON = Lundi ... 6, Sat, SAT = Samedi | , - * / L # |
* | année | (Facultatif) Vous pouvez spécifier les paramètres de l'année si nécessaire. La valeur par défaut est *. | , - * / |
Caractères spéciaux
Vous pouvez utiliser les caractères spéciaux suivants dans vos expressions cron.
Caractère | Description |
---|---|
* | (
« toutes les valeurs »
) Caractère générique correspondant à toutes les valeurs possibles dans le champ. Par exemple, si vous voulez que votre déclencheur se déclenche toutes les minutes pendant une heure à partir de 22 h, le caractère minute dans l'expression doit être
|
- | Spécifiez une plage de valeurs. Par exemple, vous pouvez utiliser
|
, | Spécifiez un ensemble distinct de valeurs. Par exemple, l'entrée
|
/ | Spécifiez les incréments du champ dans les unités du champ. Par exemple,
|
L | La dernière valeur acceptée dans la plage est acceptée dans les champs suivants :
|
W | Spécifie le jour de la semaine correspondant le plus proche. Par exemple, l'entrée
Astuce
|
# | Spécifie le nième jour du mois. Exemples pour le champ du jour de la semaine :
|
Exemples
Voici quelques exemples de planifications cron.
Toutes les heures
S'exécute à la quinzième minute de chaque heure :
15 * * * *
Quotidienne
S'exécute tous les jours à 22 h :
0 22 * * *
S'exécute toutes les minutes pendant une heure à partir de 22 h, tous les jours :
* 22 * * *
Hebdomadaire
S'exécute tous les mardis à 3 h :
0 3 * * 2
Jours de la semaine
S'exécute tous les jours de la semaine à 20 h :
0 20 * * 1-5
Notez que la planification ci-dessus s'exécute à 20 h le lundi soir et chaque soir de la semaine à cette heure.
Pour chaque matin de la semaine, vous pouvez choisir de démarrer les planifications le dimanche, où la valeur du jour de la semaine commence par 0 et se termine par 4.
Mensuelle
S'exécute le premier jour de chaque mois à 2 h 30 :
30 2 1 * *
S'exécute à 15 h 30 le jour de la semaine (W) le plus proche du 25e jour du mois :
30 15 25W * *
Si le 25 est un samedi, la planification se déclenche le vendredi 24.
Si le 25 est un dimanche, la planification se déclenche le lundi 26.
Annuel
S'exécute à minuit le 1er janvier de chaque année :
0 0 1 1 * *
Autres exemples
Expression | Signification |
---|---|
0 12 * * * | Exécution à 12 h (midi) tous les jours |
15 10 * * * | Exécution à 10 h 15 tous les jours |
15 10 * * * | Exécution à 10 h 15 tous les jours |
15 10 * * * * | Exécution à 10 h 15 tous les jours |
15 10 * * * 2017 | Exécution à 10 h 15 tous les jours de l'année 2017 |
* 14 * * * | Exécution toutes les minutes à partir de 14 h jusqu'à 14 h 59, tous les jours |
0/5 14 * * * | Exécution toutes les 5 minutes à partir de 14 h jusqu'à 14 h 55, tous les jours |
0/5 14,18 * * * | Exécution toutes les 5 minutes à partir de 14 h jusqu'à 14 h 55 ET exécution toutes les 5 minutes à partir de 18 h jusqu'à 18 h 55, tous les jours |
0-5 14 * * * | Exécution toutes les minutes à partir de 14 h jusqu'à 14 h 05, tous les jours |
10,44 14 * 3 WED | Exécution à 14 h 10 et à 14 h 44 tous les mercredis du mois de mars. |
15 10 * * MON-FRI | Exécution à 10 h 15 tous les lundis, mardis, mercredis, jeudis et vendredis |
15 10 15 * * | Exécution à 10 h 15 le 15e jour de chaque mois |
15 10 L * * | Exécution à 10 h 15 le dernier jour de chaque mois |
15 10 L-2 * * | Exécution à 10 h 15 le deuxième avant-dernier jour de chaque mois |
15 10 * * 5L | Exécution à 10 h 15 le dernier vendredi de chaque mois |
15 10 * * 5L 2017-2019 | Exécution à 10 h 15 tous les derniers vendredis de chaque mois en 2017, 2018 et 2019 |
15 10 * * 5#3 | Exécution à 10 h 15 le troisième vendredi de chaque mois |
0 12 1/5 * * | Exécution à 12 h (midi) tous les 5 jours chaque mois, à partir du premier jour du mois. |
11 11 11 11 * | Exécution tous les 11 novembre à 11 h 11. |
Expressions cron non prises en charge
Note
AAC ne prend pas en charge la combinaison des caractères spéciaux
/
et
-
dans les mêmes expressions.
Plutôt que d'exprimer des plages en syntaxe cron, vous pouvez référencer toutes les options possibles.
Expression non valide | Expression valide |
---|---|
0 23 * 1-11/2 * * | 0 23 * 2,4,6,8,10 * * |
Expressions cron non valides
Expression | Signification | Raison |
---|---|---|
15 10 * * * 2001 | Exécution à 10 h 15 tous les jours de l'année 2001 | Cette expression cron n'est pas valide car elle ne générera aucun événement dans le futur. |
* * * | - | L'expression cron doit comporter 6 ou 7 champs. |