Condividi tramite

ScheduleRecurrence Classe

  • Riferimento

Definisce la frequenza, l'intervallo e l'ora di inizio di una pipeline Schedule.

ScheduleRecurrence consente anche di specificare il fuso orario e le ore o i minuti o i giorni della settimana per la ricorrenza.

Inizializzare una ricorrenza della pianificazione.

Consente inoltre di specificare il fuso orario e le ore o i minuti o i giorni della settimana per la ricorrenza.

Ereditarietà
builtins.object
ScheduleRecurrence

Costruttore

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

Parametri

frequency
str
Necessario

Unità di tempo che descrive la frequenza con cui viene attivata la pianificazione. Può essere "Minute", "Hour", "Day", "Week" o "Month".

interval
int
Necessario

Valore che specifica la frequenza di attivazione della pianificazione in base alla frequenza, ovvero il numero di unità di tempo da attendere fino a quando la pianificazione non viene nuovamente attivata.

start_time
datetime oppure str
valore predefinito: None

Oggetto datetime che descrive la data e l'ora di inizio. La proprietà tzinfo dell'oggetto datetime deve essere nessuna, utilizzare time_zone la proprietà per specificare un fuso orario, se necessario. È anche possibile specificare questo parametro come stringa in questo formato: AAAA-MM-GGThh:mm:ss. Se None viene specificato, il primo carico di lavoro viene eseguito immediatamente e i carichi di lavoro futuri vengono eseguiti in base alla pianificazione. Se l'ora di inizio è passata, il primo carico di lavoro viene eseguito alla successiva esecuzione calcolata.

Se start_time corrisponde week_days a e time_of_day (o hours e minutes), il primo carico di lavoro non viene eseguito in start_time, ma viene eseguito al successivo runtime calcolato.

time_zone
TimeZone
valore predefinito: None

Specificare il fuso orario dell'oggetto start_time. Se non viene specificato Nessuna UTC viene usata.

hours
list[int]
valore predefinito: None

Se si specifica "Day" o "Week" per frequency, è possibile specificare uno o più numeri interi da 0 a 23, separati da virgole, come ore del giorno in cui si vuole eseguire il flusso di lavoro. Ad esempio, se si specifica "10", "12" e "14", gli indicatori di ora corrisponderanno alle 10.00, alle 12.00 e alle 14.00. Nota: solo time_of_day o hours e minutes possono essere usati.

minutes
list[int]
valore predefinito: None

Se si specifica "Day" o "Week" per frequency, è possibile specificare uno o più numeri interi da 0 a 59, separati da virgole, come minuti dell'ora in cui si vuole eseguire il flusso di lavoro. Ad esempio, è possibile specificare "30" come indicatore dei minuti e, usando l'esempio precedente per le ore del giorno, si otterranno le ore 10.30, 12.30 e 14.30. Nota: solo time_of_day o hours e minutes possono essere usati.

week_days
list[str]
valore predefinito: None

Se si specifica "Settimana" per la frequenza, è possibile specificare uno o più giorni, separati da virgole, quando si desidera eseguire il flusso di lavoro: "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday" e "Sunday".

time_of_day
str
valore predefinito: None

Se si specifica "Giorno" o "Settimana" per la frequenza, è possibile specificare un'ora del giorno per l'esecuzione della pianificazione come stringa nel formato hh:mm. Ad esempio, se si specifica "15:30", la pianificazione verrà eseguita alle 3:30. Nota: only time_of_day o hours e minutes possono essere usati.

frequency
str
Necessario

Unità di tempo che descrive la frequenza con cui viene attivata la pianificazione. Può essere "Minute", "Hour", "Day", "Week" o "Month".

interval
int
Necessario

Valore che specifica la frequenza di attivazione della pianificazione in base alla frequenza, ovvero il numero di unità di tempo da attendere fino a quando la pianificazione non viene nuovamente attivata.

start_time
datetime oppure str
Necessario

Oggetto datetime che descrive la data e l'ora di inizio. L'tzinfo dell'oggetto datetime deve essere nessuno, utilizzare time_zone proprietà per specificare un fuso orario, se necessario. Può anche essere una stringa in questo formato: AAAA-MM-GGThh:mm:ss. Se None viene fornito il primo carico di lavoro viene eseguito immediatamente e i carichi di lavoro futuri vengono eseguiti in base alla pianificazione. Se l'ora di inizio è passata, il primo carico di lavoro viene eseguito alla successiva esecuzione calcolata.

Se start_time corrisponde week_days a e time_of_day (o hours e minutes), il primo carico di lavoro non viene eseguito in start_time, ma viene eseguito al successivo runtime calcolato.

time_zone
TimeZone
Necessario

Specificare il fuso orario del start_time. Se non viene specificato Nessuna UTC viene usata.

hours
list[int]
Necessario

Se si specifica "Day" o "Week" per frequency, è possibile specificare uno o più numeri interi da 0 a 23, separati da virgole, come ore del giorno in cui si vuole eseguire il flusso di lavoro. Ad esempio, se si specifica "10", "12" e "14", gli indicatori di ora corrisponderanno alle 10.00, alle 12.00 e alle 14.00. Nota: è possibile usare solo time_of_day o ore e minuti.

minutes
list[int]
Necessario

Se si specifica "Day" o "Week" per frequency, è possibile specificare uno o più numeri interi da 0 a 59, separati da virgole, come minuti dell'ora in cui si vuole eseguire il flusso di lavoro. Ad esempio, è possibile specificare "30" come indicatore dei minuti e, usando l'esempio precedente per le ore del giorno, si otterranno le ore 10.30, 12.30 e 14.30. Nota: è possibile usare solo time_of_day o ore e minuti.

week_days
list[str]
Necessario

Se si specifica "Settimana" per la frequenza, è possibile specificare uno o più giorni, separati da virgole, quando si desidera eseguire il flusso di lavoro: "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday" e "Sunday"

time_of_day
str
Necessario

Se si specifica "Giorno" o "Settimana" per la frequenza, è possibile specificare un'ora del giorno per l'esecuzione della pianificazione come stringa nel formato hh:mm. Ad esempio, se si specifica "15:30", la pianificazione verrà eseguita alle 3:30. Nota: è possibile usare solo time_of_day o ore e minuti.

Commenti

Quando si crea una pianificazione per una pipeline, si usa ScheduleRecurrence come indicato di seguito:


   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)

Di seguito sono riportati alcuni esempi di scheduleRecurrence valide:


   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")

Metodi

validate

Convalidare la ricorrenza della pianificazione.

validate

Convalidare la ricorrenza della pianificazione.

validate()