Share via

CLI (v2) feladatütemezési YAML-séma

  • Cikk

ÉRVÉNYES:Azure CLI ml-bővítmény 2-es verzió (aktuális)

A forrás JSON-séma a következő helyen https://azuremlschemas.azureedge.net/latest/schedule.schema.jsontalálható: .

Megjegyzés:

A dokumentumban részletezett YAML-szintaxis az ML CLI v2 bővítmény legújabb verziójának JSON-sémáján alapul. Ez a szintaxis garantáltan csak az ML CLI v2 bővítmény legújabb verziójával működik. A régebbi bővítményverziók sémáit a következő helyen https://azuremlschemasprod.azureedge.net/találja: .

YAML-szintaxis

Kulcs Type Description Megengedett értékek
$schema sztring A YAML-séma.
name sztring Szükséges. Az ütemezés neve.
description sztring Az ütemezés leírása.
tags object Az ütemezés címkéinek szótára.
trigger object Az eseményindító konfigurációja, amely meghatározza, hogy mikor kell aktiválni a feladatot. Az egyik vagy RecurrenceTriggerCronTrigger kötelező.
create_job objektum vagy sztring Szükséges. Az ütemezés által aktivált feladat definíciója. Az egyik vagy stringJobDefinition kötelező.

Triggerkonfiguráció

Ismétlődési eseményindító

Kulcs Type Description Megengedett értékek
type sztring Szükséges. Megadja az ütemezés típusát. recurrence
frequency sztring Szükséges. Megadja az ütemezési tűzesetek gyakoriságát leíró időegységet. minute, hour, day, weekmonth
interval egész szám Szükséges. Azt az időközt adja meg, amikor az ütemezés kigyullad.
start_time sztring A kezdési dátumot és időpontot az időzónával írja le. Ha start_time nincs megadva, az első feladat azonnal lefut, és a jövőbeli feladatok az ütemezés alapján lesznek aktiválva, mondván, start_time egyenlő lesz a létrehozott feladattal. Ha a kezdési időpont a múltban van, az első feladat a következő számított futtatási időpontban fog futni.
end_time sztring A befejezési dátumot és időt időzónával írja le. Ha a end_time nincs megadva, az ütemezés addig fut, amíg explicit módon le nem tiltja.
timezone sztring Az ismétlődés időzónáját adja meg. Ha nincs megadva, alapértelmezés szerint UTC. Az időzónák értékeit lásd a függelékben
pattern object Az ismétlődés mintáját adja meg. Ha a minta hiányzik, a feladat(ok) a start_time, gyakoriság és intervallum logikája szerint lesznek aktiválva.

Ismétlődés ütemezése

Az ismétlődési ütemezés határozza meg az ismétlődési mintát, amely hourstartalmazza az , minutesés weekdaysa .

  • Ha a gyakoriság az day, a minta megadhatja hours és minutes.
  • Ha a gyakoriság és monthweek a , a minta megadhatjahours, minutes és weekdays.
Kulcs Típus Megengedett értékek
hours egész szám vagy egész szám tömbje 0-23
minutes egész szám vagy egész szám tömbje 0-59
week_days sztring vagy sztringtömb monday, tuesday, wednesday, thursdayfriday, saturdaysunday

CronTrigger

Kulcs Type Description Megengedett értékek
type sztring Szükséges. Megadja az ütemezés típusát. Cron
expression sztring Szükséges. Megadja a cron kifejezést, amely meghatározza a feladatok aktiválásának módját. az expression standard crontab kifejezést használ egy ismétlődő ütemezés kifejezéséhez. Egyetlen kifejezés öt szóközzel tagolt mezőből áll:MINUTES HOURS DAYS MONTHS DAYS-OF-WEEK
start_time sztring A kezdési dátumot és időpontot az időzónával írja le. Ha start_time nincs megadva, az első feladat azonnal lefut, és a jövőbeli feladatok az ütemezés alapján lesznek aktiválva, mondván, start_time egyenlő lesz a létrehozott feladattal. Ha a kezdési időpont a múltban van, az első feladat a következő számított futtatási időpontban fog futni.
end_time sztring A befejezési dátumot és időt időzónával írja le. Ha a end_time nincs megadva, az ütemezés addig fut, amíg explicit módon le nem tiltja.
timezone sztring Az ismétlődés időzónáját adja meg. Ha nincs megadva, alapértelmezés szerint UTC. Az időzónák értékeit lásd a függelékben

Feladat definíciója

Az ügyfél közvetlenül használhatja create_job: azureml:<job_name> vagy használhatja a következő tulajdonságokat a feladat meghatározásához.

Kulcs Type Description Megengedett értékek
type sztring Szükséges. A feladat típusát adja meg. Csak a folyamatfeladat támogatott. pipeline
job sztring Szükséges. Megadhatja, hogyan hivatkozhat azureml:<job_name> egy feladatra, lehet az vagy egy helyi folyamatfeladat, például file:hello-pipeline.yml.
experiment_name sztring Kísérlet neve a feladat rendszerezéséhez. Minden feladat futási rekordja a megfelelő kísérlet alatt lesz rendszerezve a stúdió "Kísérletek" lapján. Ha nincs megadva, az ütemezés nevét fogjuk alapértelmezett értékként venni.
inputs object A feladat bemeneteinek szótára. A kulcs a feladat környezetében lévő bemenet neve, az érték pedig a bemeneti érték.
outputs object A feladat kimeneti konfigurációinak szótára. A kulcs a feladat környezetében lévő kimenet neve, az érték pedig a kimeneti konfiguráció.
settings object A folyamatfeladat alapértelmezett beállításai. A konfigurálható tulajdonságok halmazához lásd a settings kulcs attribútumait.

A kulcs attribútumai settings

Kulcs Type Description Default value
default_datastore sztring A folyamatfeladat alapértelmezett adattáraként használni kívánt adattár neve. Ennek az értéknek a szintaxist használó meglévő adattárra kell hivatkoznia a azureml:<datastore-name> munkaterületen. A szülőfolyamat-feladat vagy a outputs gyermeklépési feladatok tulajdonságában definiált kimenetek ebben az adattárban lesznek tárolva. Ha nincs megadva, a kimenetek a munkaterület blobadattárában lesznek tárolva.
default_compute sztring A folyamat összes lépéséhez alapértelmezett számítási célként használni kívánt számítási cél neve. Ha a számítás a lépés szintjén van definiálva, az felülírja az adott lépéshez tartozó alapértelmezett számítást. Ennek az értéknek a szintaxist használó azureml:<compute-name> , a munkaterületen meglévő számításra kell hivatkoznia.
continue_on_step_failure Logikai Azt jelzi, hogy a folyamat lépéseinek végrehajtása folytatódjon-e, ha egy lépés meghiúsul. Az alapértelmezett érték az False, ami azt jelenti, hogy ha egy lépés meghiúsul, a folyamat végrehajtása le lesz állítva, megszakítva a futó lépéseket. False

Feladatbemenetek

Kulcs Type Description Megengedett értékek Default value
type sztring A feladatbemenet típusa. Adja meg uri_file az egyetlen fájlforrásra ható bemeneti adatokat, illetve uri_folder a mappaforrásra ható bemeneti adatokat. uri_file, uri_folder uri_folder
path sztring A bemenetként használni kívánt adatok elérési útja. Ez többféleképpen is megadható:

- Az adatforrásfájl vagy -mappa helyi elérési útja, például path: ./iris.csv. Az adatok feltöltése a feladat elküldése során fog befejeződni.

- A bemenetként használni kívánt fájl vagy mappa felhőbeli elérési útjának URI-ja. A támogatott URI-típusok a következőkazureml: , https, wasbs, abfssadl. Az URI-formátum használatáról további információt a azureml:// Core yaml szintaxisában talál.

- Egy meglévő regisztrált Azure Machine Tanulás adategységet, amelyet bemenetként szeretne használni. Regisztrált adategységre való hivatkozáshoz használja a azureml:<data_name>:<data_version> szintaxist vagy azureml:<data_name>@latest (az adategység legújabb verziójára való hivatkozáshoz), például vagy path: azureml:cifar10-data:1path: azureml:cifar10-data@latest.
mode sztring Az adatok számítási célba való kézbesítésének módja.

Írásvédett csatlakoztatásro_mount () esetén az adatok csatlakoztatási útvonalként lesznek felhasználva. Egy mappa mappaként lesz csatlakoztatva, a fájl pedig fájlként lesz csatlakoztatva. Az Azure Machine Tanulás feloldja a csatlakoztatási útvonal bemenetét.

Üzemmód esetén download az adatok a számítási célra lesznek letöltve. Az Azure Machine Tanulás feloldja a letöltött elérési út bemenetét.

Ha az adatok csatlakoztatása vagy letöltése helyett csak az adatösszetevő(k) tárolási helyének URL-címét szeretné használni, használhatja a direct módot. Ez a feladat bemeneteként a tárolási hely URL-címét adja meg. Ebben az esetben teljes mértékben Ön a felelős a tárhoz való hozzáféréshez szükséges hitelesítő adatok kezeléséért.		 ro_mount, , downloaddirect ro_mount

Feladatkimenetek

Kulcs Type Description Megengedett értékek Default value
type sztring A feladat kimenetének típusa. Az alapértelmezett uri_folder típus esetében a kimenet egy mappának felel meg. uri_folder uri_folder
path sztring A bemenetként használni kívánt adatok elérési útja. Ez többféleképpen is megadható:

- Az adatforrásfájl vagy -mappa helyi elérési útja, például path: ./iris.csv. Az adatok feltöltése a feladat elküldése során fog befejeződni.

- A bemenetként használni kívánt fájl vagy mappa felhőbeli elérési útjának URI-ja. A támogatott URI-típusok a következőkazureml: , https, wasbs, abfssadl. Az URI-formátum használatáról további információt a azureml:// Core yaml szintaxisában talál.

- Egy meglévő regisztrált Azure Machine Tanulás adategységet, amelyet bemenetként szeretne használni. Regisztrált adategységre való hivatkozáshoz használja a azureml:<data_name>:<data_version> szintaxist vagy azureml:<data_name>@latest (az adategység legújabb verziójára való hivatkozáshoz), például vagy path: azureml:cifar10-data:1path: azureml:cifar10-data@latest.
mode sztring A kimeneti fájlok céltárolóba való kézbesítésének módja. Olvasási-írási csatlakoztatási mód (rw_mount) esetén a kimeneti könyvtár csatlakoztatott könyvtár lesz. Feltöltési mód esetén az írott fájl(ok) a feladat végén lesznek feltöltve. rw_mount, upload rw_mount

Remarks

A az ml schedule parancs az Azure Machine Tanulás modellek kezelésére használható.

Példák

A példák a GitHub-adattárban érhetők el. Alább egy pár látható.

YAML: Ütemezés ismétlődési mintával

ÉRVÉNYES:Azure CLI ml-bővítmény 2-es verzió (aktuális)

$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: Ütemezés cron kifejezéssel

ÉRVÉNYES:Azure CLI ml-bővítmény 2-es verzió (aktuális)

$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

Függelék

Időzóna

Az aktuális ütemezés a következő időzónákat támogatja. A kulcs közvetlenül a Python SDK-ban használható, míg az érték a YAML-feladatban használható. A táblázatot UTC (koordinált egyetemes idő) szerint rendezi.

UTC Key Érték
UTC -12:00 DATELINE_STANDARD_TIME "Dateline Standard Time"
UTC -11:00 UTC_11 "UTC-11"
UTC - 10:00 ALEUTIAN_STANDARD_TIME Aleutian standard idő
UTC - 10:00 HAWAIIAN_STANDARD_TIME "Hawaii téli idő"
UTC -09:30 MARQUESAS_STANDARD_TIME "Marquesas Standard Time"
UTC -09:00 ALASKAN_STANDARD_TIME "Alaszkai téli idő"
UTC -09:00 UTC_09 "UTC-09"
UTC -08:00 PACIFIC_STANDARD_TIME_MEXICO "Csendes-óceáni téli idő (Mexikó)"
UTC -08:00 UTC_08 "UTC-08"
UTC -08:00 PACIFIC_STANDARD_TIME "Csendes-óceáni téli idő"
UTC -07:00 US_MOUNTAIN_STANDARD_TIME "US Mountain Standard Time"
UTC -07:00 MOUNTAIN_STANDARD_TIME_MEXICO "Hegyi téli idő (Mexikó)"
UTC -07:00 MOUNTAIN_STANDARD_TIME "Hegyi téli idő"
UTC -06:00 CENTRAL_AMERICA_STANDARD_TIME "Közép-Amerika standard ideje"
UTC -06:00 CENTRAL_STANDARD_TIME "Központi téli idő"
UTC -06:00 EASTER_ISLAND_STANDARD_TIME "Húsvét-szigeti téli idő"
UTC -06:00 CENTRAL_STANDARD_TIME_MEXICO "Közép-téli idő (Mexikó)"
UTC -06:00 CANADA_CENTRAL_STANDARD_TIME "Kanada középső téli ideje"
UTC -05:00 SA_PACIFIC_STANDARD_TIME "SA Pacific Standard Time"
UTC -05:00 EASTERN_STANDARD_TIME_MEXICO "Keleti téli idő (Mexikó)"
UTC -05:00 EASTERN_STANDARD_TIME "Keleti téli idő"
UTC -05:00 HAITI_STANDARD_TIME "Haiti téli idő"
UTC -05:00 CUBA_STANDARD_TIME "Kuba standard idő"
UTC -05:00 US_EASTERN_STANDARD_TIME "USA keleti téli idő"
UTC -05:00 TURKS_AND_CAICOS_STANDARD_TIME "Turks and Caicos Standard Time"
UTC -04:00 PARAGUAY_STANDARD_TIME "Paraguayi téli idő"
UTC -04:00 ATLANTIC_STANDARD_TIME "Atlanti-óceáni téli idő"
UTC -04:00 VENEZUELA_STANDARD_TIME "Venezuelai téli idő"
UTC -04:00 CENTRAL_BRAZILIAN_STANDARD_TIME "Közép-brazíliai téli idő"
UTC -04:00 SA_WESTERN_STANDARD_TIME "Sa Western Standard Time"
UTC -04:00 PACIFIC_SA_STANDARD_TIME "Pacific SA standard idő"
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. Dél-Amerika standard ideje"
UTC -03:00 SA_EASTERN_STANDARD_TIME "SA keleti téli idő"
UTC -03:00 ARGENTINA_STANDARD_TIME "Argentínai téli idő"
UTC -03:00 GR Enterprise kiadásNLAND_STANDARD_TIME "Grönlandi téli idő"
UTC -03:00 MONTEVIDEO_STANDARD_TIME "Montevideo Standard Time"
UTC -03:00 SAINT_PIERRE_STANDARD_TIME "Saint Pierre standard idő"
UTC -03:00 BAHIA_STANDARD_TIM "Bahia standard idő"
UTC -02:00 UTC_02 "UTC-02"
UTC -02:00 MID_ATLANTIC_STANDARD_TIME "Közép-atlanti standard idő"
UTC -01:00 AZORES_STANDARD_TIME "Azori-i téli idő"
UTC -01:00 CAPE_VERDE_STANDARD_TIME "Zöld-foki-szigeteki téli idő"
UTC UTC UTC
UTC +00:00 GMT_STANDARD_TIME "GMT standard idő"
UTC +00:00 GR Enterprise kiadásNWICH_STANDARD_TIME "Greenwichi téli idő"
UTC +01:00 MOROCCO_STANDARD_TIME "Marokkói téli idő"
UTC +01:00 W_EUROPE_STANDARD_TIME "W. Európai téli idő"
UTC +01:00 CENTRAL_EUROPE_STANDARD_TIME "Közép-Európa standard ideje"
UTC +01:00 ROMANCE_STANDARD_TIME "Romantika standard idő"
UTC +01:00 CENTRAL_EUROPEAN_STANDARD_TIME "Közép-európai téli idő"
UTC +01:00 W_CENTRAL_AFRICA_STANDARD_TIME "W. Közép-Afrika standard ideje"
UTC +02:00 NAMIBIA_STANDARD_TIME "Namíbia standard idő"
UTC +02:00 JORDAN_STANDARD_TIME "Jordánia téli idő"
UTC +02:00 GTB_STANDARD_TIME "GTB standard idő"
UTC +02:00 MIDDLE_EAST_STANDARD_TIME "Közel-Keleti téli idő"
UTC +02:00 EGYPT_STANDARD_TIME "Egyiptomi téli idő"
UTC +02:00 E_EUROPE_STANDARD_TIME "E. Európai téli idő"
UTC +02:00 SYRIA_STANDARD_TIME "Szíriai téli idő"
UTC +02:00 WEST_BANK_STANDARD_TIME "West Bank Standard Time"
UTC +02:00 SOUTH_AFRICA_STANDARD_TIME "Dél-Afrikai Téli idő"
UTC +02:00 FLE_STANDARD_TIME "FLE standard idő"
UTC +02:00 ISRAEL_STANDARD_TIME "Izrael standard idő"
UTC +02:00 KALININGRAD_STANDARD_TIME "Kalinyingrádi téli idő"
UTC +02:00 LIBYA_STANDARD_TIME "Líbiai téli idő"
UTC +03:00 TÜRKIYE_STANDARD_TIME "Türkiye Standard Time"
UTC +03:00 ARABIC_STANDARD_TIME "Arab téli idő"
UTC +03:00 ARAB_STANDARD_TIME "Arab téli idő"
UTC +03:00 BELARUS_STANDARD_TIME "Fehéroroszországi téli idő"
UTC +03:00 RUSSIAN_STANDARD_TIME "Orosz téli idő"
UTC +03:00 E_AFRICA_STANDARD_TIME "E. Afrika téli idő"
UTC +03:30 IRAN_STANDARD_TIME "Iráni téli idő"
UTC +04:00 ARABIAN_STANDARD_TIME "Arab téli idő"
UTC +04:00 ASTRAKHAN_STANDARD_TIME "Astrakhan standard idő"
UTC +04:00 AZERBAIJAN_STANDARD_TIME "Azerbajdzsáni téli idő"
UTC +04:00 RUSSIA_TIME_ZONE_3 "Oroszország időzóna 3"
UTC +04:00 MAURITIUS_STANDARD_TIME "Mauritius standard idő"
UTC +04:00 GEORGIAN_STANDARD_TIME "Grúz téli idő"
UTC +04:00 CAUCASUS_STANDARD_TIME "Kaukázusi téli idő"
UTC +04:30 AFGHANISTAN_STANDARD_TIME "Afganisztáni téli idő"
UTC +05:00 WEST_ASIA_STANDARD_TIME "Nyugat-Ázsia standard ideje"
UTC +05:00 EKATERINBURG_STANDARD_TIME "Jekatyerinburgi téli idő"
UTC +05:00 PAKISTAN_STANDARD_TIME "Pakisztáni téli idő"
UTC +05:30 INDIA_STANDARD_TIME "India standard idő"
UTC +05:30 SRI_LANKA_STANDARD_TIME "Sri Lanka standard idő"
UTC +05:45 NEPAL_STANDARD_TIME "Nepáli téli idő"
UTC +06:00 CENTRAL_ASIA_STANDARD_TIME "Közép-Ázsia standard ideje"
UTC +06:00 BANGLADESH_STANDARD_TIME "Bangladesi téli idő"
UTC +06:30 MYANMAR_STANDARD_TIME "Mianmari téli idő"
UTC +07:00 N_CENTRAL_ASIA_STANDARD_TIME "N. Közép-Ázsia standard ideje"
UTC +07:00 Standard kiadás_ASIA_STANDARD_TIME "Standard kiadás Asia Standard Time"
UTC +07:00 ALTAI_STANDARD_TIME "Altai Standard Time"
UTC +07:00 W_MONGOLIA_STANDARD_TIME "W. Mongolia standard idő"
UTC +07:00 NORTH_ASIA_STANDARD_TIME "Észak-Ázsia téli idő"
UTC +07:00 TOMSK_STANDARD_TIME "Tomsk Standard Time"
UTC +08:00 CHINA_STANDARD_TIME "Kínai téli idő"
UTC +08:00 NORTH_ASIA_EAST_STANDARD_TIME "Észak-Ázsia keleti téli idő"
UTC +08:00 SINGAPORE_STANDARD_TIME "Szingapúri téli idő"
UTC +08:00 W_AUSTRALIA_STANDARD_TIME "W. Ausztráliai téli idő"
UTC +08:00 TAIPEI_STANDARD_TIME "Taipei Standard Time"
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 "Észak-Korea téli idő"
UTC +09:00 TRANSBAIKAL_STANDARD_TIME "Transbaikal Standard Time"
UTC +09:00 TOKYO_STANDARD_TIME "Tokiói téli idő"
UTC +09:00 KOREA_STANDARD_TIME "Koreai téli idő"
UTC +09:00 YAKUTSK_STANDARD_TIME "Yakutsk Standard Time"
UTC +09:30 CEN_AUSTRALIA_STANDARD_TIME "Cen. Ausztráliai téli idő"
UTC +09:30 AUS_CENTRAL_STANDARD_TIME "AUS központi standard idő"
UTC +10:00 E_AUSTRALIAN_STANDARD_TIME "E. Ausztráliai téli idő"
UTC +10:00 AUS_EASTERN_STANDARD_TIME "AUS keleti téli idő"
UTC +10:00 WEST_PACIFIC_STANDARD_TIME "Nyugat-csendes-óceáni téli idő"
UTC +10:00 TASMANIA_STANDARD_TIME "Tasmania Standard Time"
UTC +10:00 VLADIVOSTOK_STANDARD_TIME "Vladivostok Standard Time"
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 "Oroszország időzóna 10"
UTC +11:00 MAGADAN_STANDARD_TIME "Magadan standard idő"
UTC +11:00 NORFOLK_STANDARD_TIME "Norfolk Standard Time"
UTC +11:00 SAKHALIN_STANDARD_TIME "Szahalin standard idő"
UTC +11:00 CENTRAL_PACIFIC_STANDARD_TIME "Közép-csendes-óceáni téli idő"
UTC +12:00 RUSSIA_TIME_ZONE_11 "Oroszország időzóna 11"
UTC +12:00 NEW_ZEALAND_STANDARD_TIME "Új-zélandi téli idő"
UTC +12:00 UTC_12 "UTC+12"
UTC +12:00 FIJI_STANDARD_TIME "Fidzsi-szigeteki téli idő"
UTC +12:00 KAMCHATKA_STANDARD_TIME "Kamchatka standard idő"
UTC +12:45 CHATHAM_ISLANDS_STANDARD_TIME "Chatham-szigeteki téli idő"
UTC +13:00 TONGA__STANDARD_TIME "Tonga standard idő"
UTC +13:00 SAMOA_STANDARD_TIME "Samoa standard idő"
UTC +14:00 LINE_ISLANDS_STANDARD_TIME "Vonal-szigeteki téli idő"