Partager via

ScheduleRecurrence Classe

Définit la fréquence, l’intervalle et l’heure de début d’un pipeline Schedule.

ScheduleRecurrence vous permet également de spécifier le fuseau horaire et les heures ou minutes ou jours de semaine pour la périodicité.

Initialisez une périodicité de planification.

Il permet également de spécifier le fuseau horaire et les heures ou minutes ou jours de semaine pour la périodicité.

Constructeur

ScheduleRecurrence(frequency, interval, start_time=None, time_zone=None, hours=None, minutes=None, week_days=None, time_of_day=None)

Paramètres

Nom Description
frequency
Obligatoire
str

Unité de temps qui décrit la fréquence à laquelle la planification se déclenche. Peut être « Minute », « Heure », « Jour », « Semaine » ou « Mois ».
interval
Obligatoire
int

Valeur qui spécifie la fréquence à laquelle la planification se déclenche en fonction de la fréquence, qui correspond au nombre d’unités de temps à attendre jusqu’à ce que la planification se déclenche à nouveau.
start_time
datetime ou str

Objet datetime qui décrit la date et l’heure de début. Le tzinfo de l’objet datetime ne doit être aucun, utilisez time_zone la propriété pour spécifier un fuseau horaire si nécessaire. Vous pouvez également spécifier ce paramètre en tant que chaîne au format suivant : AAAA-MM-DDThh :mm :ss. Si aucun n’est fourni, la première charge de travail est exécutée instantanément et les charges de travail futures sont exécutées en fonction de la planification. Si l’heure de début est dans le passé, la première charge de travail est exécutée au moment d’exécution calculé suivant.

Si start_time les correspondances week_days et time_of_day (ou et hoursminutes), la première charge de travail ne s’exécute pas à start_time, mais s’exécute à la place au moment de l’exécution calculée suivante.

Valeur par défaut: None
time_zone
TimeZone

Spécifiez le fuseau horaire du start_time. Si aucun n’est fourni UTC est utilisé.

Valeur par défaut: None
hours
list[int]

Si vous spécifiez « Jour » ou « Semaine » pour la fréquence, vous pouvez spécifier un ou plusieurs entiers compris entre 0 et 23, séparés par des virgules, comme les heures du jour où vous souhaitez exécuter le flux de travail. Par exemple, si vous spécifiez « 10 », « 12 » et « 14 », vous obtenez 10h00, 12h00 et 14h00 comme marques horaires. Remarque : uniquement time_of_day ou hoursminutes peut être utilisé.

Valeur par défaut: None
minutes
list[int]

Si vous spécifiez « Jour » ou « Semaine » pour la fréquence, vous pouvez spécifier un ou plusieurs entiers compris entre 0 et 59, séparés par des virgules, comme minutes de l’heure lorsque vous souhaitez exécuter le flux de travail. Par exemple, vous pouvez spécifier « 30 » pour les minutes et à l’aide de l’exemple précédent des heures de la journée, vous obtenez 10h30, 12h30 et 14h30. Remarque : uniquement time_of_day ou hoursminutes peut être utilisé.

Valeur par défaut: None
week_days
list[str]

Si vous spécifiez « Semaine » pour la fréquence, vous pouvez spécifier un ou plusieurs jours, séparés par des virgules, lorsque vous souhaitez exécuter le flux de travail : « Lundi », « Mardi », « Mercredi », « Jeudi », « Vendredi », « Samedi » et « Dimanche ».

Valeur par défaut: None
time_of_day
str

Si vous spécifiez « Jour » ou « Semaine » pour la fréquence, vous pouvez spécifier une heure de jour pour que la planification s’exécute en tant que chaîne sous la forme hh :mm. Par exemple, si vous spécifiez « 15:30 », la planification s’exécute à 15 h 30. Remarque : only time_of_day ou hoursminutes peut être utilisé.

Valeur par défaut: None
frequency
Obligatoire
str

Unité de temps qui décrit la fréquence à laquelle la planification se déclenche. Peut être « Minute », « Heure », « Jour », « Semaine » ou « Mois ».
interval
Obligatoire
int

Valeur qui spécifie la fréquence à laquelle la planification se déclenche en fonction de la fréquence, qui correspond au nombre d’unités de temps à attendre jusqu’à ce que la planification se déclenche à nouveau.
start_time
Obligatoire
datetime ou str

Objet datetime qui décrit la date et l’heure de début. Le tzinfo de l’objet datetime ne doit être aucun, utilisez time_zone propriété pour spécifier un fuseau horaire si nécessaire. Peut également être une chaîne au format suivant : AAAA-MM-DDThh :mm :ss. Si Aucune n’est fournie, la première charge de travail est exécutée instantanément et les charges de travail futures sont exécutées en fonction de la planification. Si l’heure de début est dans le passé, la première charge de travail est exécutée au moment d’exécution calculé suivant.

Si start_time les correspondances week_days et time_of_day (ou et hoursminutes), la première charge de travail ne s’exécute pas à start_time, mais s’exécute à la place au moment de l’exécution calculée suivante.
time_zone
Obligatoire
TimeZone

Spécifiez le fuseau horaire du start_time. Si aucun n’est fourni UTC est utilisé.
hours
Obligatoire
list[int]

Si vous spécifiez « Jour » ou « Semaine » pour la fréquence, vous pouvez spécifier un ou plusieurs entiers compris entre 0 et 23, séparés par des virgules, comme les heures du jour où vous souhaitez exécuter le flux de travail. Par exemple, si vous spécifiez « 10 », « 12 » et « 14 », vous obtenez 10h00, 12h00 et 14h00 comme marques horaires. Remarque : seules time_of_day ou heures et minutes peuvent être utilisées.
minutes
Obligatoire
list[int]

Si vous spécifiez « Jour » ou « Semaine » pour la fréquence, vous pouvez spécifier un ou plusieurs entiers compris entre 0 et 59, séparés par des virgules, comme minutes de l’heure lorsque vous souhaitez exécuter le flux de travail. Par exemple, vous pouvez spécifier « 30 » pour les minutes et à l’aide de l’exemple précédent des heures de la journée, vous obtenez 10h30, 12h30 et 14h30. Remarque : seules time_of_day ou heures et minutes peuvent être utilisées.
week_days
Obligatoire
list[str]

Si vous spécifiez « Semaine » pour la fréquence, vous pouvez spécifier un ou plusieurs jours, séparés par des virgules, lorsque vous souhaitez exécuter le flux de travail : « Lundi », « Mardi », « Mercredi », « Jeudi », « Vendredi », « Samedi », « Samedi » et « Dimanche »
time_of_day
Obligatoire
str

Si vous spécifiez « Jour » ou « Semaine » pour la fréquence, vous pouvez spécifier une heure de jour pour que la planification s’exécute en tant que chaîne sous la forme hh :mm. Par exemple, si vous spécifiez « 15:30 », la planification s’exécute à 15 h 30. Remarque : seules time_of_day ou heures et minutes peuvent être utilisées.

Remarques

Une planificationRecurrence est utilisée lors de la création d’une planification pour un pipeline comme suit :


   from azureml.pipeline.core import Schedule, ScheduleRecurrence

   recurrence = ScheduleRecurrence(frequency="Hour", interval=12)
   schedule = Schedule.create(workspace, name="TestSchedule", pipeline_id=pipeline.id,
                              experiment_name="experiment_name", recurrence=recurrence)

Voici quelques exemples de ScheduleRecurrences valides :


   from azureml.pipeline.core import ScheduleRecurrence

   # Submit the Pipeline every 15 minutes
   recurrence = ScheduleRecurrence(frequency="Minute", interval=15)
   # Submit the Pipeline every 2 weeks on Monday and Wednesday at 6:30pm UTC
   recurrence = ScheduleRecurrence(frequency="Week", interval=2, week_days=["Monday", "Wednesday"],
                                   time_of_day="18:30")
   # Submit the Pipeline on the first day of every month starting November 1, 2019 at 9AM
   recurrence = ScheduleRecurrence(frequency="Month", interval=1, start_time="2019-11-01T09:00:00")
   # Submit the Pipeline every hour on the 55th minute starting on January 13th, 2020 at 12:55pm
   # if the specified start time is in the past, the first workload is run at the next future 55th minute
   # of the hour.
   recurrence = ScheduleRecurrence(frequency="Hour", interval=1, start_time="2020-01-13T12:55:00")

Méthodes

validate

Validez la périodicité de la planification.

validate

Validez la périodicité de la planification.

validate()