Sdílet prostřednictvím

Schéma YAML plánu importu rozhraní příkazového řádku (v2)

  • Článek

PLATÍ PRO: Rozšíření Azure CLI ml v2 (aktuální)

Zdrojové schéma JSON najdete na adrese https://azuremlschemas.azureedge.net/latest/schedule.schema.json.

Poznámka:

Syntaxe YAML podrobná v tomto dokumentu je založená na schématu JSON pro nejnovější verzi rozšíření ML CLI v2. Tato syntaxe je zaručena pouze pro práci s nejnovější verzí rozšíření ML CLI v2. Schémata pro starší verze rozšíření najdete na adrese https://azuremlschemasprod.azureedge.net/.

Syntaxe YAML

Klíč Typ Popis Povolené hodnoty
$schema string Schéma YAML.
name string Povinný: Název plánu
description string Popis plánu
tags objekt Slovník značek pro plán
trigger objekt Konfigurace triggeru definující pravidlo, kdy se má aktivovat úloha. Jedna z RecurrenceTrigger nebo CronTrigger je povinná.
import_data objekt nebo řetězec Povinný: Definice akce importu dat, kterou plán aktivoval. Jedna z string nebo ImportDataDefinition je povinná.

Konfigurace triggeru

Trigger opakování

Klíč Typ Popis Povolené hodnoty
type string Povinný: Určuje typ plánu. recurrence
frequency string Povinný: Určuje jednotku času, která popisuje, jak často se plán aktivuje. minute, hour, day, , weekmonth
interval integer Povinný: Určuje interval, ve kterém se plán aktivuje.
start_time string Popisuje počáteční datum a čas pomocí časového pásma. Pokud start_time vynecháte, spustí se první úloha okamžitě a budoucí úlohy se aktivují na základě plánu, takže start_time bude odpovídat času vytvoření úlohy. Pokud je čas spuštění v minulosti, spustí se první úloha při příštím počítaném běhu.
end_time string Popisuje koncové datum a čas s časovým pásmem. Pokud end_time vynecháte, plán se spustí, dokud ho explicitně nezakážete.
timezone string Určuje časové pásmo opakování. Pokud tento parametr vynecháte, je ve výchozím nastavení UTC. Viz dodatek k hodnotám časového pásma.
pattern objekt Určuje způsob opakování. Pokud vzor vynecháte, úlohy se aktivují podle logiky start_time, četnosti a intervalu.

Plán opakování

Plán opakování definuje způsob opakování, který obsahuje hoursminutes, a weekdays.

  • Pokud je dayfrekvence , model může určit hours a minutes.
  • Je-li week frekvence a month, vzor může určit hours, minutes a weekdays.
Klíč Typ Povolené hodnoty
hours celé číslo nebo pole celého čísla 0-23
minutes celé číslo nebo pole celého čísla 0-59
week_days řetězec nebo pole řetězce monday, tuesday, wednesday, thursday, friday, , saturdaysunday

CronTrigger

Klíč Typ Popis Povolené hodnoty
type string Povinný: Určuje typ plánu. cron
expression string Povinný: Určuje výraz cron, který definuje, jak aktivovat úlohy. výraz používá standardní výraz crontab k vyjádření opakujícího se plánu. Jeden výraz se skládá z pěti polí oddělených mezerami:MINUTES HOURS DAYS MONTHS DAYS-OF-WEEK
start_time string Popisuje počáteční datum a čas pomocí časového pásma. Pokud start_time vynecháte, spustí se první úloha okamžitě a budoucí úlohy se aktivují podle plánu a řekne, start_time bude odpovídat času vytvoření úlohy. Pokud je čas spuštění v minulosti, spustí se první úloha při příštím počítaném běhu.
end_time string Popisuje koncové datum a čas s časovým pásmem. Pokud end_time vynecháte, plán se bude dál spouštět, dokud nebude explicitně zakázaný.
timezone string Určuje časové pásmo opakování. Pokud tento parametr vynecháte, je ve výchozím nastavení UTC. Viz dodatek k hodnotám časového pásma.

Import definice dat (Preview)

Důležité

Tato funkce je v současné době ve verzi Public Preview. Tato verze Preview je poskytována bez smlouvy o úrovni služeb a nedoporučujeme ji pro produkční úlohy. Některé funkce se nemusí podporovat nebo mohou mít omezené možnosti.

Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.

Zákazník může přímo použít nebo může k definování definice importu dat použít import_data: ./<data_import>.yaml následující vlastnosti.

Klíč Typ Popis Povolené hodnoty
type string Povinný: Určuje datový typ assetu, který chcete importovat jako. Při importu ze zdroje databáze může být mltable nebo uri_folder při importu z FileSource. mltable, uri_folder
name string Povinný: Název datového assetu pro registraci importovaných dat v části.
path string Povinný: Cesta k úložišti dat, která přebírá importovaná data, určená jedním ze dvou způsobů:

- Požadovaný. Identifikátor URI cesty úložiště dat. Pouze podporovaný typ identifikátoru URI je azureml. Další informace o tom, jak používat formát identifikátoru azureml:// URI, najdete v tématu Syntaxe Core yaml. Pokud se chcete vyhnout přepisování, doporučuje se pro každý import jedinečná cesta. Chcete-li to provést, parametrizovat cestu, jak je znázorněno v tomto příkladu - azureml://datastores/<datastore_name>/paths/<source_name>/${{name}}. "datastore_name" v příkladu může být úložiště dat, které jste vytvořili, nebo může být workspaceblobstore. Alternativně lze vybrat "spravované úložiště dat" odkazem, jak je znázorněno: azureml://datastores/workspacemanagedstore, kde systém automaticky přiřadí jedinečnou cestu.		 Azure Machine Learning://<>
source objekt Podrobnosti o externím zdroji importovaného zdroje dat Viz Atributy source sady zdrojových vlastností.

source Atributy (Preview)

Klíč Typ Popis Povolené hodnoty Default value
type string Typ externího zdroje, ze kterého chcete importovat data. V tuto chvíli jsou povoleny pouze následující typy – Database nebo FileSystem Database, FileSystem
query string Tuto hodnotu definujte pouze v případě, type že výše definovaná hodnota je database dotaz v externím zdroji typu Database , který definuje nebo filtruje data, která je potřeba importovat.
path string Tuto hodnotu definujte pouze v případě type , že je výše definovaná FileSystem cesta ke složce v externím zdroji typu FileSystem , kde se nacházejí soubory nebo data, která je potřeba importovat.
connection string Povinný: Vlastnost připojení pro externí zdroj odkazovaný ve formátu azureml:<connection_name>

Důležité

Tato funkce je v současné době ve verzi Public Preview. Tato verze Preview je poskytována bez smlouvy o úrovni služeb a nedoporučujeme ji pro produkční úlohy. Některé funkce se nemusí podporovat nebo mohou mít omezené možnosti.

Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.

Poznámky

Tento az ml schedule příkaz se dá použít ke správě modelů Azure Machine Learning.

Příklady

Příklady jsou k dispozici v příkladech v úložišti GitHub. Níže je uvedeno několik.

YAML: Naplánování importu dat se vzorem opakování

PLATÍ PRO: Rozšíření Azure CLI ml v2 (aktuální)

YAML: Plán importu dat se vzorem opakování (Preview)

$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: Naplánování vložené definice importu dat se vzorem opakování ve spravovaném úložišti dat (Preview)

$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: Naplánování importu dat pomocí výrazu cron

PLATÍ PRO: Rozšíření Azure CLI ml v2 (aktuální)

YAML: Naplánování importu dat pomocí výrazu cron (Preview)

$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: Plán definice importu dat vložený s výrazem cron (Preview)

$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

Dodatek

Časové pásmo

Aktuální plán podporuje časové pásmo v této tabulce. Klíč lze použít přímo v sadě Python SDK, zatímco hodnotu je možné použít v importu dat YAML. Tabulka je seřazená podle standardu UTC (Coordinated Universal Time).

UTC Key Hodnota
UTC -12:00 DATELINE_STANDARD_TIME "Dateline Standard Time"
UTC -11:00 UTC_11 "UTC-11"
UTC – 10:00 ALEUTIAN_STANDARD_TIME Aleutian Standard Time
UTC – 10:00 HAWAIIAN_STANDARD_TIME "Havajský standardní čas"
UTC -09:30 MARQUESAS_STANDARD_TIME "Marquesas Standard Time"
UTC -09:00 ALASKAN_STANDARD_TIME "Aljaška standardní čas"
UTC -09:00 UTC_09 "UTC-09"
UTC -08:00 PACIFIC_STANDARD_TIME_MEXICO "Pacific Standard Time (Mexiko)"
UTC -08:00 UTC_08 "UTC-08"
UTC -08:00 PACIFIC_STANDARD_TIME "Tichomoří – standardní čas"
UTC -07:00 US_MOUNTAIN_STANDARD_TIME "US Mountain Standard Time"
UTC -07:00 MOUNTAIN_STANDARD_TIME_MEXICO "Horská standardní doba (Mexiko)"
UTC -07:00 MOUNTAIN_STANDARD_TIME "Horská standardní doba"
UTC -06:00 CENTRAL_AMERICA_STANDARD_TIME "Střední Amerika – standardní čas"
UTC -06:00 CENTRAL_STANDARD_TIME "Centrální standardní čas"
UTC -06:00 EASTER_ISLAND_STANDARD_TIME "Velikonoční ostrov Standardní čas"
UTC -06:00 CENTRAL_STANDARD_TIME_MEXICO "Central Standard Time (Mexiko)"
UTC -06:00 CANADA_CENTRAL_STANDARD_TIME "Kanada – střed standardní čas"
UTC -05:00 SA_PACIFIC_STANDARD_TIME "SA Pacific Standard Time"
UTC -05:00 EASTERN_STANDARD_TIME_MEXICO "Východní standardní čas (Mexiko)"
UTC -05:00 EASTERN_STANDARD_TIME "Východní standardní čas"
UTC -05:00 HAITI_STANDARD_TIME "Haiti – standardní čas"
UTC -05:00 CUBA_STANDARD_TIME "Kuba – standardní čas"
UTC -05:00 US_EASTERN_STANDARD_TIME "USA – východ – standardní čas"
UTC -05:00 TURKS_AND_CAICOS_STANDARD_TIME "Turks And Caicos Standardní čas"
UTC -04:00 PARAGUAY_STANDARD_TIME "Paraguay – standardní čas"
UTC -04:00 ATLANTIC_STANDARD_TIME "Atlantic Standard Time"
UTC -04:00 VENEZUELA_STANDARD_TIME "Venezuelský standardní čas"
UTC -04:00 CENTRAL_BRAZILIAN_STANDARD_TIME "Střední brazilský standardní čas"
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. Jižní Amerika Standardní čas"
UTC -03:00 SA_EASTERN_STANDARD_TIME "SA Eastern Standard Time"
UTC -03:00 ARGENTINA_STANDARD_TIME "Argentina Standard Time"
UTC -03:00 GREENLAND_STANDARD_TIME "Greenland Standard Time"
UTC -03:00 MONTEVIDEO_STANDARD_TIME "Montevideo Standardní čas"
UTC -03:00 SAINT_PIERRE_STANDARD_TIME "Saint Pierre Standard Time"
UTC -03:00 BAHIA_STANDARD_TIM "Bahia Standard Time"
UTC -02:00 UTC_02 "UTC-02"
UTC -02:00 MID_ATLANTIC_STANDARD_TIME "Mid-Atlantic Standard Time"
UTC -01:00 AZORES_STANDARD_TIME "Azores Standard Time"
UTC -01:00 CAPE_VERDE_STANDARD_TIME "Kapverdský standardní čas"
UTC UTC UTC
UTC +00:00 GMT_STANDARD_TIME "GMT Standard Time"
UTC +00:00 GREENWICH_STANDARD_TIME "Greenwich Standard Time"
UTC +01:00 MOROCCO_STANDARD_TIME "Maroko Standardní čas"
UTC +01:00 W_EUROPE_STANDARD_TIME "W. Evropský standardní čas"
UTC +01:00 CENTRAL_EUROPE_STANDARD_TIME "Střední Evropa – standardní čas"
UTC +01:00 ROMANCE_STANDARD_TIME "Romantika standardního času"
UTC +01:00 CENTRAL_EUROPEAN_STANDARD_TIME "Středoevropský standardní čas"
UTC +01:00 W_CENTRAL_AFRICA_STANDARD_TIME "W. Střední Afrika – standardní čas"
UTC +02:00 NAMIBIA_STANDARD_TIME "Namibie – standardní čas"
UTC +02:00 JORDAN_STANDARD_TIME "Jordan Standard Time"
UTC +02:00 GTB_STANDARD_TIME "GTB Standard Time"
UTC +02:00 MIDDLE_EAST_STANDARD_TIME "Střední východ – standardní čas"
UTC +02:00 EGYPT_STANDARD_TIME "Egypt Standardní čas"
UTC +02:00 E_EUROPE_STANDARD_TIME "E. Evropský standardní čas"
UTC +02:00 SYRIA_STANDARD_TIME "Sýrie – standardní čas"
UTC +02:00 WEST_BANK_STANDARD_TIME "Standardní čas západní banky"
UTC +02:00 SOUTH_AFRICA_STANDARD_TIME "Jihoafrická republika – standardní čas"
UTC +02:00 FLE_STANDARD_TIME "FLE Standardní čas"
UTC +02:00 ISRAEL_STANDARD_TIME "Izrael – standardní čas"
UTC +02:00 KALININGRAD_STANDARD_TIME "Kaliningrad – standardní čas"
UTC +02:00 LIBYA_STANDARD_TIME "Libye standardní čas"
UTC +03:00 TÜRKIYE_STANDARD_TIME "Türkiye Standard Time"
UTC +03:00 ARABIC_STANDARD_TIME "Arabský standardní čas"
UTC +03:00 ARAB_STANDARD_TIME "Arabský standardní čas"
UTC +03:00 BELARUS_STANDARD_TIME "Bělorusko Standardní čas"
UTC +03:00 RUSSIAN_STANDARD_TIME "Ruský standardní čas"
UTC +03:00 E_AFRICA_STANDARD_TIME "E. Afrika Standardní čas"
UTC +03:30 IRAN_STANDARD_TIME "Írán – standardní čas"
UTC +04:00 ARABIAN_STANDARD_TIME "Arabský standardní čas"
UTC +04:00 ASTRAKHAN_STANDARD_TIME "Astrakhan Standard Time"
UTC +04:00 AZERBAIJAN_STANDARD_TIME "Ázerbájdžán – standardní čas"
UTC +04:00 RUSSIA_TIME_ZONE_3 "Rusko – časové pásmo 3"
UTC +04:00 MAURITIUS_STANDARD_TIME "Mauricius Standardní čas"
UTC +04:00 GEORGIAN_STANDARD_TIME "Georgian Standard Time"
UTC +04:00 CAUCASUS_STANDARD_TIME "Bělošský standardní čas"
UTC +04:30 AFGHANISTAN_STANDARD_TIME "Afghánistán – standardní čas"
UTC +05:00 WEST_ASIA_STANDARD_TIME "Západní Asie – standardní čas"
UTC +05:00 EKATERINBURG_STANDARD_TIME "Ekaterinburg Standard Time"
UTC +05:00 PAKISTAN_STANDARD_TIME "Pákistán – standardní čas"
UTC +05:30 INDIA_STANDARD_TIME "Indie – standardní čas"
UTC +05:30 SRI_LANKA_STANDARD_TIME "Srí Lanka Standardní čas"
UTC +05:45 NEPAL_STANDARD_TIME "Nepál – standardní čas"
UTC +06:00 CENTRAL_ASIA_STANDARD_TIME "Střední Asie – standardní čas"
UTC +06:00 BANGLADESH_STANDARD_TIME "Bangladéš – standardní čas"
UTC +06:30 MYANMAR_STANDARD_TIME "Myanmar – standardní čas"
UTC +07:00 N_CENTRAL_ASIA_STANDARD_TIME "N. Střední Asie – standardní čas"
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. Mongolsko standardní čas"
UTC +07:00 NORTH_ASIA_STANDARD_TIME "Severní Asie – standardní čas"
UTC +07:00 TOMSK_STANDARD_TIME "Tomsk Standard Time"
UTC + 08:00 CHINA_STANDARD_TIME "Čína – standardní čas"
UTC + 08:00 NORTH_ASIA_EAST_STANDARD_TIME "Severní Asie – východ – standardní čas"
UTC + 08:00 SINGAPORE_STANDARD_TIME "Singapur – standardní čas"
UTC + 08:00 W_AUSTRALIA_STANDARD_TIME "W. Austrálie ( standardní čas)
UTC + 08:00 TAIPEI_STANDARD_TIME "Tchaj-pej – standardní čas"
UTC + 08:00 ULAANBAATAR_STANDARD_TIME "Ulaanbaatar Standard Time"
UTC +08:45 AUS_CENTRAL_W_STANDARD_TIME "Aus Central W. Standard Time"
UTC +09:00 NORTH_KOREA_STANDARD_TIME "Severní Korea – standardní čas"
UTC +09:00 TRANSBAIKAL_STANDARD_TIME "Transbaikal Standard Time"
UTC +09:00 TOKYO_STANDARD_TIME "Tokyo Standard Time"
UTC +09:00 KOREA_STANDARD_TIME "Korea Standard Time"
UTC +09:00 YAKUTSK_STANDARD_TIME "Yakutsk Standard Time"
UTC +09:30 CEN_AUSTRALIA_STANDARD_TIME "Cen. Austrálie ( standardní čas)
UTC +09:30 AUS_CENTRAL_STANDARD_TIME "AUS Central Standard Time"
UTC +10:00 E_AUSTRALIAN_STANDARD_TIME "E. Austrálie ( standardní čas)
UTC +10:00 AUS_EASTERN_STANDARD_TIME "AUS Eastern Standard Time"
UTC +10:00 WEST_PACIFIC_STANDARD_TIME "West Pacific Standard Time"
UTC +10:00 TASMANIA_STANDARD_TIME "Tasmania Standard Time"
UTC +10:00 VLADIVOSTOK_STANDARD_TIME "Směrodatný čas"
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 "Rusko – časové pásmo 10"
UTC +11:00 MAGADAN_STANDARD_TIME "Magadan Standard Time"
UTC +11:00 NORFOLK_STANDARD_TIME "Norfolk Standard Time"
UTC +11:00 SAKHALIN_STANDARD_TIME "Sakhalin Standardní čas"
UTC +11:00 CENTRAL_PACIFIC_STANDARD_TIME "Střední Tichomoří – standardní čas"
UTC +12:00 RUSSIA_TIME_ZONE_11 "Rusko – časové pásmo 11"
UTC +12:00 NEW_ZEALAND_STANDARD_TIME "Nový Zéland Standardní čas"
UTC +12:00 UTC_12 "UTC+12"
UTC +12:00 FIJI_STANDARD_TIME "Fiji Standard Time"
UTC +12:00 KAMCHATKA_STANDARD_TIME "Kamchatka Standardní čas"
UTC +12:45 CHATHAM_ISLANDS_STANDARD_TIME "Chatham Islands Standard Time"
UTC +13:00 TONGA__STANDARD_TIME "Tonga Standard Time"
UTC +13:00 SAMOA_STANDARD_TIME "Samoa Standard Time"
UTC +14:00 LINE_ISLANDS_STANDARD_TIME "Line Islands Standard Time"