Schema YAML della pianificazione dell'importazione 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. |
|
import_data |
oggetto o stringa | Obbligatorio. Definizione dell'azione di importazione dei dati attivata da una pianificazione. Uno di string o ImportDataDefinition è 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 , week month |
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 vengono attivati in base alla pianificazione, dicendo start_time corrisponderà all'ora di creazione del processo. Se la data e ora di inizio è nel passato, il primo processo viene eseguito alla data e ora di esecuzione successiva calcolata. | |
end_time |
string | Descrive la data e l'ora di fine con il fuso orario. Se end_time viene omesso, la pianificazione viene 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 vengono attivati in base alla logica di start_time, frequenza e intervallo. |
Pianificazione ricorrenza
La pianificazione ricorrenza definisce il criterio di ricorrenza, contenente hours
, minutes
e weekdays
.
- Quando la frequenza è
day
, il criterio può specificarehours
eminutes
. - Quando la frequenza è
week
emonth
, il criterio può specificarehours
,minutes
eweekdays
.
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 , thursday friday , , saturday sunday |
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 vengono attivati in base alla pianificazione, dicendo start_time corrisponderà all'ora di creazione del processo. Se la data e ora di inizio è nel passato, il primo processo viene eseguito alla data e ora di esecuzione successiva calcolata. | |
end_time |
string | Descrive la data e l'ora di fine con il fuso orario. Se end_time viene omesso, la pianificazione continua 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 |
Importare la definizione dei dati (anteprima)
Importante
Questa funzionalità è attualmente in anteprima pubblica. Questa versione di anteprima viene fornita senza contratto di servizio, pertanto se ne sconsiglia l’uso per i carichi di lavoro in ambienti di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate.
Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.
Il cliente può usare import_data: ./<data_import>.yaml
direttamente o usare le proprietà seguenti per definire la definizione di importazione dei dati.
Chiave | Type | Descrizione | Valori consentiti |
---|---|---|---|
type |
string | Obbligatorio. Specifica il tipo di asset di dati che si desidera importare i dati come . Può essere mltable durante l'importazione da un'origine database o uri_folder durante l'importazione da un oggetto FileSource. | mltable , uri_folder |
name |
string | Obbligatorio. Nome dell'asset di dati in cui registrare i dati importati. | |
path |
string | Obbligatorio. Percorso dell'archivio dati che accetta i dati importati, specificato in uno dei due modi seguenti: - Obbligatorio. URI del percorso dell'archivio dati. Solo il tipo di URI supportato è azureml . Per altre informazioni su come usare il azureml:// formato URI, vedere sintassi yaml di base. Per evitare un over-write, è consigliabile usare un percorso univoco per ogni importazione. A tale scopo, parametrizzare il percorso come illustrato in questo esempio : azureml://datastores/<datastore_name>/paths/<source_name>/${{name}} . Il "datastore_name" nell'esempio può essere un archivio dati creato o può essere workspaceblobstore. In alternativa, è possibile selezionare un "archivio dati gestito" facendo riferimento a : azureml://datastores/workspacemanagedstore , dove il sistema assegna automaticamente un percorso univoco. |
Azure Machine Learning://<> |
source |
oggetto | Dettagli dell'origine dati esterna dell'origine dati importata. Vedere Attributi di source per il set di proprietà di origine. |
Attributi di source
(anteprima)
Chiave | Type | Descrizione | Valori consentiti | Valore predefinito |
---|---|---|---|---|
type |
string | Tipo di origine esterna da cui si intende importare i dati. Al momento sono consentiti solo i tipi seguenti: Database o FileSystem |
Database , FileSystem |
|
query |
string | Definire questo valore solo quando l'oggetto type precedente definito è database La query nell'origine esterna di tipo Database che definisce o filtra i dati che devono essere importati. |
||
path |
string | Definire questo valore solo quando il type valore precedente definito è FileSystem Il percorso della cartella nell'origine esterna di tipo FileSystem in cui risiedono i file o i dati che devono essere importati. |
||
connection |
string | Obbligatorio. Proprietà di connessione per l'origine esterna a cui viene fatto riferimento nel formato di azureml:<connection_name> |
Importante
Questa funzionalità è attualmente in anteprima pubblica. Questa versione di anteprima viene fornita senza contratto di servizio, pertanto se ne sconsiglia l’uso per i carichi di lavoro in ambienti di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate.
Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.
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: pianificare un'importazione di dati con modello di ricorrenza
SI APPLICA A: estensione ML dell'interfaccia della riga di comando di Azure v2 (corrente)
YAML: pianificare l'importazione dei dati con modello di ricorrenza (anteprima)
$schema: https://azuremlschemas.azureedge.net/latest/schedule.schema.json
name: simple_recurrence_import_schedule
display_name: Simple recurrence import schedule
description: a simple hourly recurrence import 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
import_data: ./my-snowflake-import-data.yaml
YAML: pianificare la definizione di importazione dei dati inline con il modello di ricorrenza nell'archivio dati gestito (anteprima)
$schema: https://azuremlschemas.azureedge.net/latest/schedule.schema.json
name: inline_recurrence_import_schedule
display_name: Inline recurrence import schedule
description: an inline hourly recurrence import 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
import_data:
type: mltable
name: my_snowflake_ds
path: azureml://datastores/workspacemanagedstore
source:
type: database
query: select * from TPCH_SF1.REGION
connection: azureml:my_snowflake_connection
YAML: pianificare un'importazione dati con un’espressione cron
SI APPLICA A: estensione ML dell'interfaccia della riga di comando di Azure v2 (corrente)
YAML: pianificare un'importazione dati con un’espressione cron (anteprima)
$schema: https://azuremlschemas.azureedge.net/latest/schedule.schema.json
name: simple_cron_import_schedule
display_name: Simple cron import schedule
description: a simple hourly cron import 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
import_data: ./my-snowflake-import-data.yaml
YAML: pianificare una definizione di importazione dati inline con un’espressione cron (anteprima)
$schema: https://azuremlschemas.azureedge.net/latest/schedule.schema.json
name: inline_cron_import_schedule
display_name: Inline cron import schedule
description: an inline hourly cron import 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
import_data:
type: mltable
name: my_snowflake_ds
path: azureml://datastores/workspaceblobstore/paths/snowflake/${{name}}
source:
type: database
query: select * from TPCH_SF1.REGION
connection: azureml:my_snowflake_connection
Appendice
FusoOrario
La pianificazione corrente supporta i fusi orari in questa tabella. La chiave può essere usata direttamente in Python SDK, mentre il valore può essere usato nell'importazione di dati YAML. La tabella viene ordinata 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" |