Condividi tramite


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