Delen via


ScheduleRecurrence Klas

Definieert de frequentie, het interval en de begintijd van een pijplijn Schedule.

Met ScheduleRecurrence kunt u ook de tijdzone en de uren of minuten of weekdagen voor het terugkeerpatroon opgeven.

Initialiseer een schema-terugkeerpatroon.

Hiermee kunt u ook de tijdzone en de uren of minuten of weekdagen voor het terugkeerpatroon opgeven.

Overname
builtins.object
ScheduleRecurrence

Constructor

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

Parameters

frequency
str
Vereist

De tijdseenheid die beschrijft hoe vaak de planning wordt geactiveerd. Kan 'Minuut', 'Uur', 'Dag', 'Week' of 'Maand' zijn.

interval
int
Vereist

Een waarde die aangeeft hoe vaak de planning wordt geactiveerd op basis van de frequentie. Dit is het aantal tijdseenheden dat moet worden gewacht totdat de planning opnieuw wordt geactiveerd.

start_time
datetime of str
standaardwaarde: None

Een datum/tijd-object dat de begindatum en -tijd beschrijft. De tzinfo van het datum/tijd-object moet geen zijn. Gebruik time_zone de eigenschap om indien nodig een tijdzone op te geven. U kunt deze parameter ook opgeven als een tekenreeks in deze notatie: JJJJ-MM-DDThh:mm:ss. Als Geen wordt opgegeven, wordt de eerste workload direct uitgevoerd en worden de toekomstige workloads uitgevoerd op basis van de planning. Als de begintijd in het verleden ligt, wordt de eerste workload uitgevoerd op de volgende berekende uitvoeringstijd.

Als start_time overeenkomt met week_days en time_of_day (of hours en minutes), wordt de eerste werkbelasting niet uitgevoerd op start_time, maar wordt in plaats daarvan uitgevoerd op de volgende berekende uitvoeringstijd.

time_zone
TimeZone
standaardwaarde: None

Geef de tijdzone van de start_timeop. Als geen is opgegeven, wordt UTC gebruikt.

hours
list[int]
standaardwaarde: None

Als u 'Dag' of 'Week' opgeeft voor frequentie, kunt u een of meer gehele getallen tussen 0 en 23, gescheiden door komma's, opgeven als de uren van de dag waarop u de werkstroom wilt uitvoeren. Als u bijvoorbeeld '10', '12' en '14' opgeeft, krijgt u 10:00, 12:00 en 14:00 uur als de uurmarkeringen. Opmerking: alleen time_of_day of hours en minutes kunnen worden gebruikt.

minutes
list[int]
standaardwaarde: None

Als u 'Dag' of 'Week' opgeeft voor frequentie, kunt u een of meer gehele getallen van 0 tot 59, gescheiden door komma's, opgeven als de minuten van het uur waarop u de werkstroom wilt uitvoeren. U kunt bijvoorbeeld '30' opgeven als minuutmarkering en als u het vorige voorbeeld gebruikt voor uren van de dag, krijgt u 10:30 uur, 12:30 uur en 14:30 uur. Opmerking: alleen time_of_day of hours en minutes kunnen worden gebruikt.

week_days
list[str]
standaardwaarde: None

Als u 'Week' opgeeft voor frequentie, kunt u een of meer dagen, gescheiden door komma's, opgeven wanneer u de werkstroom wilt uitvoeren: Maandag, Dinsdag, Woensdag, Donderdag, Vrijdag, Zaterdag en Zondag.

time_of_day
str
standaardwaarde: None

Als u 'Dag' of 'Week' opgeeft als frequentie, kunt u een tijdstip opgeven waarop de planning moet worden uitgevoerd als een tekenreeks in de vorm uu:mm. Als u bijvoorbeeld '15:30' opgeeft, wordt het schema om 15:30 uur uitgevoerd. Opmerking: only time_of_day of hours en minutes kunnen worden gebruikt.

frequency
str
Vereist

De tijdseenheid die beschrijft hoe vaak de planning wordt geactiveerd. Kan 'Minuut', 'Uur', 'Dag', 'Week' of 'Maand' zijn.

interval
int
Vereist

Een waarde die aangeeft hoe vaak de planning wordt geactiveerd op basis van de frequentie. Dit is het aantal tijdseenheden dat moet worden gewacht totdat de planning opnieuw wordt geactiveerd.

start_time
datetime of str
Vereist

Een datum/tijd-object dat de begindatum en -tijd beschrijft. De tzinfo van het datum/tijd-object moet geen zijn. Gebruik time_zone eigenschap om indien nodig een tijdzone op te geven. Kan ook een tekenreeks in deze notatie zijn: JJJJ-MM-DDThh:mm:ss. Als geen is opgegeven, wordt de eerste workload direct uitgevoerd en worden de toekomstige workloads uitgevoerd op basis van de planning. Als de begintijd in het verleden ligt, wordt de eerste workload uitgevoerd op de volgende berekende uitvoeringstijd.

Als start_time overeenkomt met week_days en time_of_day (of hours en minutes), wordt de eerste werkbelasting niet uitgevoerd op start_time, maar wordt in plaats daarvan uitgevoerd op de volgende berekende uitvoeringstijd.

time_zone
TimeZone
Vereist

Geef de tijdzone van de start_time op. Als geen is opgegeven, wordt UTC gebruikt.

hours
list[int]
Vereist

Als u 'Dag' of 'Week' opgeeft voor frequentie, kunt u een of meer gehele getallen tussen 0 en 23, gescheiden door komma's, opgeven als de uren van de dag waarop u de werkstroom wilt uitvoeren. Als u bijvoorbeeld '10', '12' en '14' opgeeft, krijgt u 10:00, 12:00 en 14:00 uur als de uurmarkeringen. Opmerking: alleen time_of_day of uren en minuten kunnen worden gebruikt.

minutes
list[int]
Vereist

Als u 'Dag' of 'Week' opgeeft voor frequentie, kunt u een of meer gehele getallen van 0 tot 59, gescheiden door komma's, opgeven als de minuten van het uur waarop u de werkstroom wilt uitvoeren. U kunt bijvoorbeeld '30' opgeven als minuutmarkering en als u het vorige voorbeeld gebruikt voor uren van de dag, krijgt u 10:30 uur, 12:30 uur en 14:30 uur. Opmerking: alleen time_of_day of uren en minuten kunnen worden gebruikt.

week_days
list[str]
Vereist

Als u 'Week' opgeeft als frequentie, kunt u een of meer dagen, gescheiden door komma's, opgeven wanneer u de werkstroom wilt uitvoeren: Maandag, Dinsdag, Woensdag, Donderdag, Vrijdag, Zaterdag en Zondag

time_of_day
str
Vereist

Als u 'Dag' of 'Week' opgeeft als frequentie, kunt u een tijdstip opgeven waarop de planning moet worden uitgevoerd als een tekenreeks in de vorm uu:mm. Als u bijvoorbeeld '15:30' opgeeft, wordt het schema om 15:30 uur uitgevoerd. Opmerking: alleen time_of_day of uren en minuten kunnen worden gebruikt.

Opmerkingen

Een ScheduleRecurrence wordt als volgt gebruikt bij het maken van een planning voor een pijplijn:


   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)

Hier volgen enkele voorbeelden van geldige ScheduleRecurrences:


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

Methoden

validate

Valideer het terugkeerpatroon van de planning.

validate

Valideer het terugkeerpatroon van de planning.

validate()