Dela via


YAML-schema för CLI-importschema (v2)

GÄLLER FÖR: Azure CLI ml-tillägget v2 (aktuellt)

JSON-källschemat finns på https://azuremlschemas.azureedge.net/latest/schedule.schema.json.

Kommentar

YAML-syntaxen som beskrivs i det här dokumentet baseras på JSON-schemat för den senaste versionen av ML CLI v2-tillägget. Den här syntaxen är garanterad att endast fungera med den senaste versionen av ML CLI v2-tillägget. Du hittar scheman för äldre tilläggsversioner på https://azuremlschemasprod.azureedge.net/.

YAML-syntax

Nyckel Typ Beskrivning Tillåtna värden
$schema sträng YAML-schemat.
name sträng Obligatoriskt. Namnet på schemat.
description sträng Beskrivning av schemat.
tags objekt Ordlista över taggar för schemat.
trigger objekt Utlösarkonfigurationen för att definiera regeln när jobbet ska utlösas. En av RecurrenceTrigger eller CronTrigger krävs.
import_data objekt eller sträng Obligatoriskt. Definitionen av den importdataåtgärd som ett schema har utlöst. En av string eller ImportDataDefinition krävs.

Utlösarkonfiguration

Återkomstutlösare

Nyckel Typ Beskrivning Tillåtna värden
type sträng Obligatoriskt. Anger schematypen. återkommande
frequency sträng Obligatoriskt. Anger den tidsenhet som beskriver hur ofta schemat utlöses. minute, hour, day, , , weekmonth
interval heltal Obligatoriskt. Anger det intervall med vilket schemat utlöses.
start_time sträng Beskriver startdatum och tid med tidszon. Om start_time utelämnas körs det första jobbet omedelbart och de framtida jobben utlöses baserat på schemat och säger att start_time matchar den tid då jobbet skapades. Om starttiden är tidigare körs det första jobbet vid nästa beräknade körningstid.
end_time sträng Beskriver slutdatum och tid med tidszon. Om end_time utelämnas körs schemat tills det uttryckligen inaktiveras.
timezone sträng Anger tidszonen för upprepningen. Om det utelämnas är UTC som standard. Se bilaga för tidszonsvärden
pattern objekt Anger mönstret för upprepningen. Om mönstret utelämnas utlöses jobben enligt logiken i start_time, frekvens och intervall.

Återkommande schema

Upprepningsschemat definierar upprepningsmönstret som innehåller hours, minutesoch weekdays.

  • När frekvensen är daykan mönstret ange hours och minutes.
  • När frekvensen är week och monthkan mönstret ange hours, minutes och weekdays.
Nyckel Typ Tillåtna värden
hours heltal eller matris med heltal 0-23
minutes heltal eller matris med heltal 0-59
week_days sträng eller strängmatris monday, tuesday, wednesday, thursday, friday, , , saturdaysunday

CronTrigger

Nyckel Typ Beskrivning Tillåtna värden
type sträng Obligatoriskt. Anger schematypen. cron
expression sträng Obligatoriskt. Anger cron-uttrycket för att definiera hur jobb ska utlösas. uttryck använder standard crontab-uttryck för att uttrycka ett återkommande schema. Ett enda uttryck består av fem blankstegsavgränsade fält:MINUTES HOURS DAYS MONTHS DAYS-OF-WEEK
start_time sträng Beskriver startdatum och tid med tidszon. Om start_time utelämnas körs det första jobbet omedelbart och de framtida jobben utlöses baserat på schemat och säger att start_time matchar jobbets skapade tid. Om starttiden är tidigare körs det första jobbet vid nästa beräknade körningstid.
end_time sträng Beskriver slutdatum och tid med tidszon. Om end_time utelämnas fortsätter schemat att köras tills det uttryckligen inaktiveras.
timezone sträng Anger tidszonen för upprepningen. Om det utelämnas är UTC som standard. Se bilaga för tidszonsvärden

Importera datadefinition (förhandsversion)

Viktigt!

Den här funktionen är för närvarande i allmänt tillgänglig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och vi rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade.

Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.

Kunden kan använda import_data: ./<data_import>.yaml eller använda följande egenskaper för att definiera dataimportdefinitionen.

Nyckel Typ Beskrivning Tillåtna värden
type sträng Obligatoriskt. Anger den datatillgångstyp som du vill importera data som. Det kan vara mltable när du importerar från en databaskälla eller uri_folder när du importerar från en FileSource. mltable, uri_folder
name sträng Obligatoriskt. Namn på datatillgång som importerade data ska registreras under.
path sträng Obligatoriskt. Sökvägen till det datalager som tar emot importerade data, som anges på något av två sätt:

- Krävs. En URI för datalagersökväg. Endast URI-typ som stöds är azureml. Mer information om hur du använder azureml:// URI-formatet finns i Core yaml-syntax. För att undvika överskrivning rekommenderas en unik sökväg för varje import. Det gör du genom att parametrisera sökvägen enligt det här exemplet – azureml://datastores/<datastore_name>/paths/<source_name>/${{name}}. "datastore_name" i exemplet kan vara ett datalager som du har skapat eller kan vara workspaceblobstore. Alternativt kan ett "hanterat datalager" väljas genom att referera till följande: azureml://datastores/workspacemanagedstore, där systemet automatiskt tilldelar en unik sökväg.
Azure Machine Learning://<>
source objekt Information om den externa källan för den importerade datakällan. Se Attribut för source för uppsättningen med källegenskaper.

Attribut för source (förhandsversion)

Nyckel Typ Beskrivning Tillåtna värden Standardvärde
type sträng Den typ av extern källa som du tänker importera data från. Endast följande typer tillåts för tillfället - Database eller FileSystem Database, FileSystem
query sträng Definiera endast det här värdet när det type som definierats ovan är database Frågan i den externa källa av typen Database som definierar eller filtrerar data som måste importeras.
path sträng Definiera endast det här värdet när det type som definierats ovan är FileSystem Mappsökvägen till mappen i den externa källa av typen FileSystem där de filer eller data som behöver importeras finns.
connection sträng Obligatoriskt. Anslutningsegenskapen för den externa källa som refereras i formatet azureml:<connection_name>

Viktigt!

Den här funktionen är för närvarande i allmänt tillgänglig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och vi rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade.

Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.

Kommentarer

Kommandot az ml schedule kan användas för att hantera Azure Machine Learning-modeller.

Exempel

Exempel är tillgängliga i GitHub-exempellagringsplatsen. Ett par visas nedan.

YAML: Schemalägg för en dataimport med upprepningsmönster

GÄLLER FÖR: Azure CLI ml-tillägget v2 (aktuellt)

YAML: Schema för dataimport med upprepningsmönster (förhandsversion)

$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: Schemalägg för dataimportdefinition infogat med upprepningsmönster i hanterat datalager (förhandsversion)

$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: Schemalägg för en dataimport med cron-uttryck

GÄLLER FÖR: Azure CLI ml-tillägget v2 (aktuellt)

YAML: Schemalägg för dataimport med cron-uttryck (förhandsversion)

$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: Schemalägg för dataimportdefinition infogat med cron-uttryck (förhandsversion)

$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

Bilaga

Tidszon

Det aktuella schemat stöder tidszonerna i den här tabellen. Nyckeln kan användas direkt i Python SDK, medan värdet kan användas i YAML för dataimport. Tabellen sorteras efter UTC (Coordinated Universal Time).

UTC Nyckel Värde
UTC -12:00 DATELINE_STANDARD_TIME "Dateline Standard Time"
UTC -11:00 UTC_11 "UTC-11"
UTC – 10:00 ALEUTIAN_STANDARD_TIME Aleutian standardtid
UTC – 10:00 HAWAIIAN_STANDARD_TIME "Hawaiian Standard Time"
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 (Mexiko)"
UTC -08:00 UTC_08 "UTC-08"
UTC -08:00 PACIFIC_STANDARD_TIME "Pacific Standard Time"
UTC -07:00 US_MOUNTAIN_STANDARD_TIME "US Mountain Standard Time"
UTC -07:00 MOUNTAIN_STANDARD_TIME_MEXICO "Mountain Standard Time (Mexiko)"
UTC -07:00 MOUNTAIN_STANDARD_TIME "Mountain Standard Time"
UTC -06:00 CENTRAL_AMERICA_STANDARD_TIME "Standardtid för Centralamerika"
UTC -06:00 CENTRAL_STANDARD_TIME "Central standardtid"
UTC -06:00 EASTER_ISLAND_STANDARD_TIME "Påsköns standardtid"
UTC -06:00 CENTRAL_STANDARD_TIME_MEXICO "Central standardtid (Mexiko)"
UTC -06:00 CANADA_CENTRAL_STANDARD_TIME "Canada Central Standard Time"
UTC -05:00 SA_PACIFIC_STANDARD_TIME "SA Pacific Standard Time"
UTC -05:00 EASTERN_STANDARD_TIME_MEXICO "Eastern Standard Time (Mexiko)"
UTC -05:00 EASTERN_STANDARD_TIME "Eastern Standard Time"
UTC -05:00 HAITI_STANDARD_TIME "Haitis standardtid"
UTC -05:00 CUBA_STANDARD_TIME "Kuba, standardtid"
UTC -05:00 US_EASTERN_STANDARD_TIME "US Eastern Standard Time"
UTC -05:00 TURKS_AND_CAICOS_STANDARD_TIME "Turks och Caicos standardtid"
UTC -04:00 PARAGUAY_STANDARD_TIME "Paraguays standardtid"
UTC -04:00 ATLANTIC_STANDARD_TIME "Atlantic Standard Time"
UTC -04:00 VENEZUELA_STANDARD_TIME "Venezuelas standardtid"
UTC -04:00 CENTRAL_BRAZILIAN_STANDARD_TIME "Central brasiliansk standardtid"
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. Sydamerika, standardtid"
UTC -03:00 SA_EASTERN_STANDARD_TIME "SA Eastern Standard Time"
UTC -03:00 ARGENTINA_STANDARD_TIME "Argentinas standardtid"
UTC -03:00 GREENLAND_STANDARD_TIME "Grönlands standardtid"
UTC -03:00 MONTEVIDEO_STANDARD_TIME "Montevideo Standard Time"
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 standardtid"
UTC -01:00 AZORES_STANDARD_TIME "Azorernas standardtid"
UTC -01:00 CAPE_VERDE_STANDARD_TIME "Kap Verdes standardtid"
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 "Marocko, standardtid"
UTC +01:00 W_EUROPE_STANDARD_TIME "W. Europa, standardtid"
UTC +01:00 CENTRAL_EUROPE_STANDARD_TIME "Centraleuropa, standardtid"
UTC +01:00 ROMANCE_STANDARD_TIME "Romansk standardtid"
UTC +01:00 CENTRAL_EUROPEAN_STANDARD_TIME "Centraleuropeiska standardtid"
UTC +01:00 W_CENTRAL_AFRICA_STANDARD_TIME "W. Centralafrika, standardtid"
UTC +02:00 NAMIBIA_STANDARD_TIME "Namibias standardtid"
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 "Mellanöstern, standardtid"
UTC +02:00 EGYPT_STANDARD_TIME "Egypten, standardtid"
UTC +02:00 E_EUROPE_STANDARD_TIME "E. Europa, standardtid"
UTC +02:00 SYRIA_STANDARD_TIME "Syrien, standardtid"
UTC +02:00 WEST_BANK_STANDARD_TIME "Standardtid på Västbanken"
UTC +02:00 SOUTH_AFRICA_STANDARD_TIME "Sydafrika, standardtid"
UTC +02:00 FLE_STANDARD_TIME "FLE Standard Time"
UTC +02:00 ISRAEL_STANDARD_TIME "Israel Standard Time"
UTC +02:00 KALININGRAD_STANDARD_TIME "Standardtid för Kaliningrad"
UTC +02:00 LIBYA_STANDARD_TIME "Libyens standardtid"
UTC +03:00 TÜRKIYE_STANDARD_TIME "Türkiye Standard Time"
UTC +03:00 ARABIC_STANDARD_TIME "Arabisk standardtid"
UTC +03:00 ARAB_STANDARD_TIME "Arabisk standardtid"
UTC +03:00 BELARUS_STANDARD_TIME "Vitrysslands standardtid"
UTC +03:00 RUSSIAN_STANDARD_TIME "Rysk standardtid"
UTC +03:00 E_AFRICA_STANDARD_TIME "E. Afrikas standardtid"
UTC +03:30 IRAN_STANDARD_TIME "Iran Standard Time"
UTC +04:00 ARABIAN_STANDARD_TIME "Arabisk standardtid"
UTC +04:00 ASTRAKHAN_STANDARD_TIME "Astrakhan Standard Time"
UTC +04:00 AZERBAIJAN_STANDARD_TIME "Azerbajdzjans standardtid"
UTC +04:00 RUSSIA_TIME_ZONE_3 "Ryssland Tidszon 3"
UTC +04:00 MAURITIUS_STANDARD_TIME "Mauritius standardtid"
UTC +04:00 GEORGIAN_STANDARD_TIME "Georgisk standardtid"
UTC +04:00 CAUCASUS_STANDARD_TIME "Kaukasus, standardtid"
UTC +04:30 AFGHANISTAN_STANDARD_TIME "Afghanistans standardtid"
UTC +05:00 WEST_ASIA_STANDARD_TIME "West Asia Standard Time"
UTC +05:00 EKATERINBURG_STANDARD_TIME "Ekaterinburg, standardtid"
UTC +05:00 PAKISTAN_STANDARD_TIME "Pakistans standardtid"
UTC +05:30 INDIA_STANDARD_TIME "Indien, standardtid"
UTC +05:30 SRI_LANKA_STANDARD_TIME "Sri Lanka Standard Time"
UTC +05:45 NEPAL_STANDARD_TIME "Nepals standardtid"
UTC +06:00 CENTRAL_ASIA_STANDARD_TIME "Central Asia Standard Time"
UTC +06:00 BANGLADESH_STANDARD_TIME "Bangladesh standardtid"
UTC +06:30 MYANMAR_STANDARD_TIME "Myanmars standardtid"
UTC +07:00 N_CENTRAL_ASIA_STANDARD_TIME "N. Centralasiens standardtid"
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. Mongoliets standardtid"
UTC +07:00 NORTH_ASIA_STANDARD_TIME "North Asia Standard Time"
UTC +07:00 TOMSK_STANDARD_TIME "Tomsk Standard Time"
UTC +08.00 CHINA_STANDARD_TIME "China Standard Time"
UTC +08.00 NORTH_ASIA_EAST_STANDARD_TIME "North Asia East Standard Time"
UTC +08.00 SINGAPORE_STANDARD_TIME "Singapore Standard Time"
UTC +08.00 W_AUSTRALIA_STANDARD_TIME "W. Australien, standardtid"
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 "Nordkoreas standardtid"
UTC +09:00 TRANSBAIKAL_STANDARD_TIME "Transbaikal standardtid"
UTC +09:00 TOKYO_STANDARD_TIME "Tokyos standardtid"
UTC +09:00 KOREA_STANDARD_TIME "Koreas standardtid"
UTC +09:00 YAKUTSK_STANDARD_TIME "Yakutsk Standard Time"
UTC +09:30 CEN_AUSTRALIA_STANDARD_TIME "Cen. Australien, standardtid"
UTC +09:30 AUS_CENTRAL_STANDARD_TIME "AUS Central Standard Time"
UTC +10:00 E_AUSTRALIAN_STANDARD_TIME "E. Australien, standardtid"
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 "Tasmaniens standardtid"
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 "Ryssland Tidszon 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 Standard Time"
UTC +11:00 CENTRAL_PACIFIC_STANDARD_TIME "Central Pacific Standard Time"
UTC +12:00 RUSSIA_TIME_ZONE_11 "Rysslands tidszon 11"
UTC +12:00 NEW_ZEALAND_STANDARD_TIME "Nyzeeländskt standardtid"
UTC +12:00 UTC_12 "UTC+12"
UTC +12:00 FIJI_STANDARD_TIME "Fijis standardtid"
UTC +12:00 KAMCHATKA_STANDARD_TIME "Kamchatka Standard Time"
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"