Condividi tramite


Schema YAML di pianificazione dei processi dell’interfaccia della riga di comando (v2)

SI APPLICA A: estensione ML dell'interfaccia della riga di comando di Azure v2 (corrente)

Lo schema JSON di origine è disponibile in https://azuremlschemas.azureedge.net/latest/schedule.schema.json.

Nota

La sintassi YAML descritta in dettaglio in questo documento si basa sullo schema JSON per la versione più recente dell'estensione dell'interfaccia della riga di comando di Machine Learning v2. Il funzionamento di questa sintassi è garantito solo con la versione più recente dell'estensione dell'interfaccia della riga di comando di Machine Learning v2. È possibile trovare gli schemi per le versioni di estensione precedenti in https://azuremlschemasprod.azureedge.net/.

Sintassi YAML

Chiave Type Descrizione Valori consentiti
$schema string Schema YAML.
name string Obbligatorio. Nome della pianificazione.
description string Descrizione della pianificazione.
tags oggetto Dizionario di tag per la pianificazione.
trigger oggetto Configurazione del trigger per definire la regola quando attivare il processo. Uno di RecurrenceTrigger o CronTrigger è obbligatorio.
create_job oggetto o stringa Obbligatorio. Definizione del processo che verrà attivato da una pianificazione. Uno di string o JobDefinition è obbligatorio.

Configurazione trigger

Trigger di ricorrenza

Chiave Type Descrizione Valori consentiti
type string Obbligatorio. Specifica il tipo di pianificazione. recurrence
frequency string Obbligatorio. Specifica l'unità di tempo che descrive la frequenza con cui viene attivata la pianificazione. minute, hour, day, weekmonth
interval integer Obbligatorio. Specifica l'intervallo in cui viene attivata la pianificazione.
start_time string Descrive la data e l'ora di inizio con il fuso orario. Se start_time viene omesso, il primo processo verrà eseguito immediatamente e i processi futuri verranno attivati in base alla pianificazione, dicendo start_time sarà uguale all'ora di creazione del processo. Se l'ora di inizio è passata, il primo processo verrà eseguito al successivo runtime calcolato.
end_time string Descrive la data e l'ora di fine con il fuso orario. Se end_time viene omesso, la pianificazione continuerà a essere eseguita fino a quando non viene disabilitata in modo esplicito.
timezone string Specifica il fuso orario della ricorrenza. Se omesso, per impostazione predefinita è UTC. Vedere l'appendice per i valori del fuso orario
pattern oggetto Specifica il modello della ricorrenza. Se il criterio viene omesso, i processi verranno attivati in base alla logica di start_time, frequenza e intervallo.

Pianificazione ricorrenza

La pianificazione ricorrenza definisce il criterio di ricorrenza, contenente hours, minutese weekdays.

  • Quando la frequenza è day, il criterio può specificare hours e minutes.
  • Quando la frequenza è week e month, il criterio può specificare hours, minutes e weekdays.
Chiave Type Valori consentiti
hours integer o matrice di integer 0-23
minutes integer o matrice di integer 0-59
week_days stringa o matrice di stringhe monday, tuesday, wednesday, thursdayfriday, , saturdaysunday

CronTrigger

Chiave Type Descrizione Valori consentiti
type string Obbligatorio. Specifica il tipo di pianificazione. cron
expression string Obbligatorio. Specifica l'espressione cron per definire come attivare i processi. Expression usa un'espressione crontab standard per esprimere una pianificazione ricorrente. Una singola espressione è costituita da cinque campi delimitati da spazi:MINUTES HOURS DAYS MONTHS DAYS-OF-WEEK
start_time string Descrive la data e l'ora di inizio con il fuso orario. Se start_time viene omesso, il primo processo verrà eseguito immediatamente e i processi futuri verranno attivati in base alla pianificazione, dicendo start_time sarà uguale all'ora di creazione del processo. Se l'ora di inizio è passata, il primo processo verrà eseguito al successivo runtime calcolato.
end_time string Descrive la data e l'ora di fine con il fuso orario. Se end_time viene omesso, la pianificazione continuerà a essere eseguita fino a quando non viene disabilitata in modo esplicito.
timezone string Specifica il fuso orario della ricorrenza. Se omesso, per impostazione predefinita è UTC. Vedere l'appendice per i valori del fuso orario

Definizione del processo

Il cliente può usare create_job: azureml:<job_name> direttamente o usare le proprietà seguenti per definire il processo.

Chiave Type Descrizione Valori consentiti
type string Obbligatorio. Specifica il tipo di processo. È supportato solo il processo della pipeline. pipeline
job string Obbligatorio. Definire come fare riferimento a un processo, può essere azureml:<job_name> o un yaml del processo della pipeline locale, file:hello-pipeline.ymlad esempio .
experiment_name string Nome dell'esperimento in cui organizzare il processo. Il record di esecuzione di ogni processo verrà organizzato nell'esperimento corrispondente nella scheda "Esperimenti" dello studio. Se omesso, il nome della pianificazione verrà preso come valore predefinito.
inputs oggetto Dizionario di input per il processo. La chiave è un nome per l'input nel contesto del processo e il valore è il valore di input.
outputs oggetto Dizionario delle configurazioni di output del processo. La chiave è un nome per l'output nel contesto del processo e il valore è la configurazione di output.
settings oggetto Impostazioni predefinite per il processo della pipeline. Vedere Attributi della settings chiave per il set di proprietà configurabili.

Attributi della settings chiave

Chiave Type Descrizione Default value
default_datastore string Nome dell'archivio dati da usare come archivio dati predefinito per il processo della pipeline. Questo valore deve essere un riferimento a un archivio dati esistente nell'area di lavoro usando la azureml:<datastore-name> sintassi . Tutti gli output definiti nella outputs proprietà del processo della pipeline padre o dei processi dei passaggi figlio verranno archiviati in questo archivio dati. Se omesso, gli output verranno archiviati nell'archivio dati BLOB dell'area di lavoro.
default_compute string Nome della destinazione di calcolo da usare come calcolo predefinito per tutti i passaggi della pipeline. Se il calcolo è definito a livello di passaggio, eseguirà l'override di questo calcolo predefinito per tale passaggio specifico. Questo valore deve essere un riferimento a un calcolo esistente nell'area di lavoro usando la azureml:<compute-name> sintassi .
continue_on_step_failure boolean Indica se l'esecuzione dei passaggi nella pipeline deve continuare se un passaggio ha esito negativo. Il valore predefinito è False, il che significa che se un passaggio ha esito negativo, l'esecuzione della pipeline verrà arrestata, annullando tutti i passaggi in esecuzione. False

Input del processo

Chiave Type Descrizione Valori consentiti Valore predefinito
type string Tipo di input del processo. Specificare uri_file per i dati di input che puntano a una singola origine file o uri_folder per i dati di input che puntano a un'origine cartella. uri_file, uri_folder uri_folder
path string Percorso dei dati da usare come input. Questa opzione può essere specificata in alcuni modi:

- Percorso locale del file o della cartella dell'origine dati, path: ./iris.csvad esempio . I dati verranno caricati durante l'invio del processo.

- URI di un percorso cloud del file o della cartella da usare come input. I tipi URI supportati sono azureml, https, wasbs, abfss, adl. Per altre informazioni su come usare il azureml:// formato URI, vedere sintassi yaml di base.

: asset di dati di Azure Machine Learning registrato esistente da usare come input. Per fare riferimento a un asset di dati registrato, usare la azureml:<data_name>:<data_version> sintassi o azureml:<data_name>@latest (per fare riferimento alla versione più recente di tale asset di dati), ad esempio path: azureml:cifar10-data:1 o path: azureml:cifar10-data@latest.
mode string Modalità di distribuzione dei dati alla destinazione di calcolo.

Per il montaggio di sola lettura (ro_mount), i dati verranno utilizzati come percorso di montaggio. Una cartella verrà montata come cartella e un file verrà montato come file. Azure Machine Learning risolverà l'input nel percorso di montaggio.

Per download la modalità i dati verranno scaricati nella destinazione di calcolo. Azure Machine Learning risolverà l'input nel percorso scaricato.

Se si vuole solo l'URL della posizione di archiviazione degli artefatti dati anziché montare o scaricare i dati stessi, è possibile usare la direct modalità . Questo passerà l'URL della posizione di archiviazione come input del processo. In questo caso, si è completamente responsabili della gestione delle credenziali per accedere all'archiviazione.
ro_mount, download, direct ro_mount

Output del processo

Chiave Type Descrizione Valori consentiti Valore predefinito
type string Tipo di output del processo. Per il tipo predefinito uri_folder , l'output corrisponderà a una cartella. uri_folder uri_folder
path string Percorso dei dati da usare come input. Questa opzione può essere specificata in alcuni modi:

- Percorso locale del file o della cartella dell'origine dati, path: ./iris.csvad esempio . I dati verranno caricati durante l'invio del processo.

- URI di un percorso cloud del file o della cartella da usare come input. I tipi URI supportati sono azureml, https, wasbs, abfss, adl. Per altre informazioni su come usare il azureml:// formato URI, vedere sintassi yaml di base.

: asset di dati di Azure Machine Learning registrato esistente da usare come input. Per fare riferimento a un asset di dati registrato, usare la azureml:<data_name>:<data_version> sintassi o azureml:<data_name>@latest (per fare riferimento alla versione più recente di tale asset di dati), ad esempio path: azureml:cifar10-data:1 o path: azureml:cifar10-data@latest.
mode string Modalità di consegna dei file di output alla risorsa di archiviazione di destinazione. Per la modalità di montaggio in lettura/scrittura (rw_mount) la directory di output sarà una directory montata. Per la modalità di caricamento, i file scritti verranno caricati alla fine del processo. rw_mount, upload rw_mount

Osservazioni:

Il az ml schedule comando può essere usato per la gestione dei modelli di Azure Machine Learning.

Esempi

Gli esempi sono disponibili nel repository GitHub di esempi. Di seguito sono riportate alcune coppie.

YAML: pianificazione con criterio di ricorrenza

SI APPLICA A: estensione ML dell'interfaccia della riga di comando di Azure v2 (corrente)

$schema: https://azuremlschemas.azureedge.net/latest/schedule.schema.json
name: simple_recurrence_job_schedule
display_name: Simple recurrence job schedule
description: a simple hourly recurrence job schedule

trigger:
  type: recurrence
  frequency: day #can be minute, hour, day, week, month
  interval: 1 #every day
  schedule:
    hours: [4,5,10,11,12]
    minutes: [0,30]
  start_time: "2022-07-10T10:00:00" # optional - default will be schedule creation time
  time_zone: "Pacific Standard Time" # optional - default will be UTC

create_job: ./simple-pipeline-job.yml
# create_job: azureml:simple-pipeline-job

YAML: pianificare con l'espressione cron

SI APPLICA A: estensione ML dell'interfaccia della riga di comando di Azure v2 (corrente)

$schema: https://azuremlschemas.azureedge.net/latest/schedule.schema.json
name: simple_cron_job_schedule
display_name: Simple cron job schedule
description: a simple hourly cron job schedule

trigger:
  type: cron
  expression: "0 * * * *"
  start_time: "2022-07-10T10:00:00" # optional - default will be schedule creation time
  time_zone: "Pacific Standard Time" # optional - default will be UTC

# create_job: azureml:simple-pipeline-job
create_job: ./simple-pipeline-job.yml

Appendice

FusoOrario

La pianificazione corrente supporta i fusi orari seguenti. La chiave può essere usata direttamente in Python SDK, mentre il valore può essere usato nel processo YAML. La tabella è organizzata in base all'ora UTC (Coordinated Universal Time).

UTC Chiave valore
UTC -12.00 DATELINE_STANDARD_TIME "Ora solare dataline"
UTC -11.00 UTC_11 "UTC-11"
UTC - 10.00 ALEUTIAN_STANDARD_TIME Ora solare Aleutine
UTC - 10.00 HAWAIIAN_STANDARD_TIME "Ora solare hawaii"
UTC -09:30 MARQUESAS_STANDARD_TIME "Marquesas Standard Time"
UTC -09:00 ALASKAN_STANDARD_TIME "Alaskan Standard Time"
UTC -09:00 UTC_09 "UTC-09"
UTC -08:00 PACIFIC_STANDARD_TIME_MEXICO "Pacific Standard Time (Messico)"
UTC -08:00 UTC_08 "UTC-08"
UTC -08:00 PACIFIC_STANDARD_TIME "Ora solare pacifico"
UTC -07.00 US_MOUNTAIN_STANDARD_TIME "Us Mountain Standard Time"
UTC -07.00 MOUNTAIN_STANDARD_TIME_MEXICO "Ora solare montagna (Messico)"
UTC -07.00 MOUNTAIN_STANDARD_TIME "Ora solare montagna"
UTC -06.00 CENTRAL_AMERICA_STANDARD_TIME "Ora solare america centrale"
UTC -06.00 CENTRAL_STANDARD_TIME "Ora solare centrale"
UTC -06.00 EASTER_ISLAND_STANDARD_TIME "Ora solare dell'Isola di Pasqua"
UTC -06.00 CENTRAL_STANDARD_TIME_MEXICO "Ora solare centrale (Messico)"
UTC -06.00 CANADA_CENTRAL_STANDARD_TIME "Ora solare centrale canada"
UTC -05:00 SA_PACIFIC_STANDARD_TIME "SA Pacific Standard Time"
UTC -05:00 EASTERN_STANDARD_TIME_MEXICO "Ora solare orientale (Messico)"
UTC -05:00 EASTERN_STANDARD_TIME "Ora solare orientale"
UTC -05:00 HAITI_STANDARD_TIME "Ora solare haitiana"
UTC -05:00 CUBA_STANDARD_TIME "Ora solare cuba"
UTC -05:00 US_EASTERN_STANDARD_TIME "Ora solare orientale degli Stati Uniti"
UTC -05:00 TURKS_AND_CAICOS_STANDARD_TIME "Turks And Caicos Standard Time"
UTC -04.00 PARAGUAY_STANDARD_TIME "Orario solare del Paraguay"
UTC -04.00 ATLANTIC_STANDARD_TIME "Ora solare atlantica"
UTC -04.00 VENEZUELA_STANDARD_TIME "Ora solare Venezuela"
UTC -04.00 CENTRAL_BRAZILIAN_STANDARD_TIME "Orario solare brasiliano centrale"
UTC -04.00 SA_WESTERN_STANDARD_TIME "SA Western Standard Time"
UTC -04.00 PACIFIC_SA_STANDARD_TIME "Pacific SA Standard Time"
UTC -03:30 NEWFOUNDLAND_STANDARD_TIME "Newfoundland Standard Time"
UTC -03:00 TOCANTINS_STANDARD_TIME "Tocantins Standard Time"
UTC -03:00 E_SOUTH_AMERICAN_STANDARD_TIME "E. Ora solare dell'America del Sud"
UTC -03:00 SA_EASTERN_STANDARD_TIME "Sa Eastern Standard Time"
UTC -03:00 ARGENTINA_STANDARD_TIME "Ora solare argentina"
UTC -03:00 GREENLAND_STANDARD_TIME "Ora solare della Groenlandia"
UTC -03:00 MONTEVIDEO_STANDARD_TIME "Ora solare di Buttono"
UTC -03:00 SAINT_PIERRE_STANDARD_TIME "Saint Pierre Standard Time"
UTC -03:00 BAHIA_STANDARD_TIM "Ora solare Di Normale"
UTC -02:00 UTC_02 "UTC-02"
UTC -02:00 MID_ATLANTIC_STANDARD_TIME "Ora solare medio Atlantico"
UTC -01:00 AZORES_STANDARD_TIME "Ora solare a livello di ora solare"
UTC -01:00 CAPE_VERDE_STANDARD_TIME "Cape Verde Standard Time"
UTC UTC UTC
UTC +00:00 GMT_STANDARD_TIME "Gmt Standard Time"
UTC +00:00 GREENWICH_STANDARD_TIME "Ora solare di Greenwich"
UTC +01:00 MOROCCO_STANDARD_TIME "Ora solare marocco"
UTC +01:00 W_EUROPE_STANDARD_TIME "W. Ora solare europa"
UTC +01:00 CENTRAL_EUROPE_STANDARD_TIME "Ora solare europa centrale"
UTC +01:00 ROMANCE_STANDARD_TIME "Tempo solare romanticismo"
UTC +01:00 CENTRAL_EUROPEAN_STANDARD_TIME "Ora solare europea centrale"
UTC +01:00 W_CENTRAL_AFRICA_STANDARD_TIME "W. Ora solare dell'Africa centrale"
UTC +02:00 NAMIBIA_STANDARD_TIME "Namibia Standard Time"
UTC +02:00 JORDAN_STANDARD_TIME "Ora solare Giordania"
UTC +02:00 GTB_STANDARD_TIME "GTB Standard Time"
UTC +02:00 MIDDLE_EAST_STANDARD_TIME "Ora solare medio oriente"
UTC +02:00 EGYPT_STANDARD_TIME "Ora solare Egitto"
UTC +02:00 E_EUROPE_STANDARD_TIME "E. Ora solare europa"
UTC +02:00 SYRIA_STANDARD_TIME "Ora solare siria"
UTC +02:00 WEST_BANK_STANDARD_TIME "Ora solare della Banca occidentale"
UTC +02:00 SOUTH_AFRICA_STANDARD_TIME "Ora solare sudafricana"
UTC +02:00 FLE_STANDARD_TIME "FLE Standard Time"
UTC +02:00 ISRAEL_STANDARD_TIME "Ora solare israele"
UTC +02:00 KALININGRAD_STANDARD_TIME "Ora solare Di Normale"
UTC +02:00 LIBYA_STANDARD_TIME "L'ora solare della Libia"
UTC +03:00 TÜRKIYE_STANDARD_TIME "Türkiye Standard Time"
UTC +03:00 ARABIC_STANDARD_TIME "Ora solare araba"
UTC +03:00 ARAB_STANDARD_TIME "Ora solare araba"
UTC +03:00 BELARUS_STANDARD_TIME "Ora solare bielorussa"
UTC +03:00 RUSSIAN_STANDARD_TIME "Ora solare russa"
UTC +03:00 E_AFRICA_STANDARD_TIME "E. Ora solare africa"
UTC +03:30 IRAN_STANDARD_TIME "Ora solare Iran"
UTC +04:00 ARABIAN_STANDARD_TIME "Ora solare araba"
UTC +04:00 ASTRAKHAN_STANDARD_TIME "Astrakhan Standard Time"
UTC +04:00 AZERBAIJAN_STANDARD_TIME "Ora solare azero"
UTC +04:00 RUSSIA_TIME_ZONE_3 "Fuso orario Russia 3"
UTC +04:00 MAURITIUS_STANDARD_TIME "Ora solare di Mauritius"
UTC +04:00 GEORGIAN_STANDARD_TIME "Ora solare georgiana"
UTC +04:00 CAUCASUS_STANDARD_TIME "Tempo solare caucasico"
UTC +04:30 AFGHANISTAN_STANDARD_TIME "Tempo solare afghanistan"
UTC +05:00 WEST_ASIA_STANDARD_TIME "Ora solare asia occidentale"
UTC +05:00 EKATERINBURG_STANDARD_TIME "Ekaterinburg Standard Time"
UTC +05:00 PAKISTAN_STANDARD_TIME "Ora solare pakistana"
UTC +05:30 INDIA_STANDARD_TIME "Ora solare India"
UTC +05:30 SRI_LANKA_STANDARD_TIME "Ora solare sri lanka"
UTC +05:45 NEPAL_STANDARD_TIME "Tempo solare nepalese"
UTC +06:00 CENTRAL_ASIA_STANDARD_TIME "Ora solare asia centrale"
UTC +06:00 BANGLADESH_STANDARD_TIME "Ora solare del Bangladesh"
UTC +06:30 MYANMAR_STANDARD_TIME "Ora solare Myanmar"
UTC +07.00 N_CENTRAL_ASIA_STANDARD_TIME "N. Ora solare asia centrale"
UTC +07.00 SE_ASIA_STANDARD_TIME "SE Asia Standard Time"
UTC +07.00 ALTAI_STANDARD_TIME "Altai Standard Time"
UTC +07.00 W_MONGOLIA_STANDARD_TIME "W. Mongolia Standard Time"
UTC +07.00 NORTH_ASIA_STANDARD_TIME "Ora solare asia settentrionale"
UTC +07.00 TOMSK_STANDARD_TIME "Ora solare Tomsk"
UTC +08:00 CHINA_STANDARD_TIME "Ora solare cina"
UTC +08:00 NORTH_ASIA_EAST_STANDARD_TIME "Ora solare asia settentrionale"
UTC +08:00 SINGAPORE_STANDARD_TIME "Ora solare singapore"
UTC +08:00 W_AUSTRALIA_STANDARD_TIME "W. Ora solare australia"
UTC +08:00 TAIPEI_STANDARD_TIME "Ora solare di Taiwan"
UTC +08:00 ULAANBAATAR_STANDARD_TIME "Ora solare Ulaanbaatar"
UTC +08:45 AUS_CENTRAL_W_STANDARD_TIME "Aus Central W. Standard Time"
UTC +09:00 NORTH_KOREA_STANDARD_TIME "Ora solare corea del Nord"
UTC +09:00 TRANSBAIKAL_STANDARD_TIME "Ora solare transbaikal"
UTC +09:00 TOKYO_STANDARD_TIME "Ora solare tokyo"
UTC +09:00 KOREA_STANDARD_TIME "Ora solare corea"
UTC +09:00 YAKUTSK_STANDARD_TIME "Ora solare di Yakuzk"
UTC +09:30 CEN_AUSTRALIA_STANDARD_TIME "Cen. Ora solare australia"
UTC +09:30 AUS_CENTRAL_STANDARD_TIME "Ora solare centrale AUS"
UTC +10:00 E_AUSTRALIAN_STANDARD_TIME "E. Ora solare australia"
UTC +10:00 AUS_EASTERN_STANDARD_TIME "Ora solare orientale AUS"
UTC +10:00 WEST_PACIFIC_STANDARD_TIME "Ora solare pacifico occidentale"
UTC +10:00 TASMANIA_STANDARD_TIME "Ora solare della Australia"
UTC +10:00 VLADIVOSTOK_STANDARD_TIME "Ora solare Di Clusterk"
UTC +10:30 LORD_HOWE_STANDARD_TIME "Lord Howe Standard Time"
UTC +11:00 BOUGAINVILLE_STANDARD_TIME "Bougainville Standard Time"
UTC +11:00 RUSSIA_TIME_ZONE_10 "Fuso orario Russia 10"
UTC +11:00 MAGADAN_STANDARD_TIME "Magadan Standard Time"
UTC +11:00 NORFOLK_STANDARD_TIME "L'ora solare di Norfolk"
UTC +11:00 SAKHALIN_STANDARD_TIME "Sakhalin Standard Time"
UTC +11:00 CENTRAL_PACIFIC_STANDARD_TIME "Ora solare pacifico centrale"
UTC +12:00 RUSSIA_TIME_ZONE_11 "Fuso orario Russia 11"
UTC +12:00 NEW_ZEALAND_STANDARD_TIME "Ora solare nuova Zelanda"
UTC +12:00 UTC_12 "UTC +12"
UTC +12:00 FIJI_STANDARD_TIME "Tempo solare Figi"
UTC +12:00 KAMCHATKA_STANDARD_TIME "Kamchatka Standard Time"
UTC +12:45 CHATHAM_ISLANDS_STANDARD_TIME "Ora solare delle Isole Chatham"
UTC +13:00 TONGA__STANDARD_TIME "Ora solare tonga"
UTC +13:00 SAMOA_STANDARD_TIME "Ora solare Samoa"
UTC +14.00 LINE_ISLANDS_STANDARD_TIME "Ora solare delle isole di linea"