Delen via

YAML-schema voor importeren van CLI (v2)

  • Artikel

VAN TOEPASSING OP: Azure CLI ml-extensie v2 (huidige)

Het JSON-bronschema vindt u op https://azuremlschemas.azureedge.net/latest/schedule.schema.json.

Notitie

De YAML-syntaxis die in dit document wordt beschreven, is gebaseerd op het JSON-schema voor de nieuwste versie van de ML CLI v2-extensie. Deze syntaxis werkt gegarandeerd alleen met de nieuwste versie van de ML CLI v2-extensie. U vindt de schema's voor oudere extensieversies op https://azuremlschemasprod.azureedge.net/.

YAML-syntaxis

Sleutel Type Description Toegestane waarden
$schema tekenreeks Het YAML-schema.
name tekenreeks Vereist. Naam van de planning.
description tekenreeks Beschrijving van de planning.
tags object Woordenlijst met tags voor de planning.
trigger object De triggerconfiguratie voor het definiëren van een regel wanneer een taak moet worden geactiveerd. Een van RecurrenceTrigger of CronTrigger is vereist.
import_data object of tekenreeks Vereist. De definitie van de importgegevensactie die een schema heeft geactiveerd. Een van string of ImportDataDefinition is vereist.

Triggerconfiguratie

Trigger met terugkeerpatroon

Sleutel Type Description Toegestane waarden
type tekenreeks Vereist. Geeft het schematype. recurrence
frequency tekenreeks Vereist. Hiermee geeft u de tijdseenheid op die beschrijft hoe vaak de planning wordt geactiveerd. minuteday, hour, weekmonth
interval geheel getal Vereist. Hiermee geeft u het interval op waarop de planning wordt geactiveerd.
start_time tekenreeks Beschrijft de begindatum en -tijd met tijdzone. Als start_time wordt weggelaten, wordt de eerste taak direct uitgevoerd en worden de toekomstige taken geactiveerd op basis van de planning, waarbij wordt aangegeven dat start_time overeenkomt met de gemaakte tijd van de taak. Als de begintijd zich in het verleden bevindt, wordt de eerste taak uitgevoerd bij de volgende berekende uitvoeringstijd.
end_time tekenreeks Beschrijft de einddatum en tijd met tijdzone. Als end_time wordt weggelaten, wordt het schema uitgevoerd totdat deze expliciet is uitgeschakeld.
timezone tekenreeks Hiermee geeft u de tijdzone van het terugkeerpatroon. Als u dit weglaat, is standaard UTC. Zie bijlage voor tijdzonewaarden
pattern object Hiermee geeft u het patroon van het terugkeerpatroon. Als u een patroon weglaat, worden de taken geactiveerd volgens de logica van start_time, frequentie en interval.

Terugkeerschema

Terugkeerschema definieert het terugkeerpatroon, met hours, minutesen weekdays.

  • Wanneer frequentie is day, kan het patroon opgeven hours en minutes.
  • Wanneer frequentie is week enmonth, kan hourshet patroon , en weekdaysminutes .
Sleutel Type Toegestane waarden
hours geheel getal of matrix van geheel getal 0-23
minutes geheel getal of matrix van geheel getal 0-59
week_days tekenreeks of matrix van tekenreeks monday, , tuesdaywednesday, thursday, , friday, , saturdaysunday

CronTrigger

Sleutel Type Description Toegestane waarden
type tekenreeks Vereist. Geeft het schematype. cron
expression tekenreeks Vereist. Hiermee geeft u de cron-expressie op om te definiëren hoe taken moeten worden geactiveerd. expressie maakt gebruik van een standaard crontab-expressie om een terugkerend schema uit te drukken. Eén expressie bestaat uit vijf door spaties gescheiden velden:MINUTES HOURS DAYS MONTHS DAYS-OF-WEEK
start_time tekenreeks Beschrijft de begindatum en -tijd met tijdzone. Als start_time wordt weggelaten, wordt de eerste taak onmiddellijk uitgevoerd en wordt de toekomstige taken geactiveerd op basis van de planning, waarin wordt aangegeven dat start_time overeenkomt met de gemaakte tijd van de taak. Als de begintijd zich in het verleden bevindt, wordt de eerste taak uitgevoerd bij de volgende berekende uitvoeringstijd.
end_time tekenreeks Beschrijft de einddatum en tijd met tijdzone. Als end_time wordt weggelaten, blijft het schema actief totdat deze expliciet is uitgeschakeld.
timezone tekenreeks Hiermee geeft u de tijdzone van het terugkeerpatroon. Als u dit weglaat, is standaard UTC. Zie bijlage voor tijdzonewaarden

Gegevensdefinitie importeren (preview)

Belangrijk

Deze functie is momenteel beschikbaar als openbare preview-versie. Deze preview-versie wordt geleverd zonder een service level agreement en we raden deze niet aan voor productieworkloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt.

Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews voor meer informatie.

De klant kan de volgende eigenschappen rechtstreeks gebruiken import_data: ./<data_import>.yaml of gebruiken om de definitie van de gegevensimport te definiëren.

Sleutel Type Description Toegestane waarden
type tekenreeks Vereist. Hiermee geeft u het gegevensassettype op dat u de gegevens wilt importeren als. Het kan mltable zijn bij het importeren uit een databasebron of uri_folder bij het importeren uit een FileSource. mltable, uri_folder
name tekenreeks Vereist. Naam van gegevensasset om de geïmporteerde gegevens te registreren.
path tekenreeks Vereist. Het pad naar het gegevensarchief dat de geïmporteerde gegevens opneemt, die op twee manieren is opgegeven:

- Vereist. Een URI van het gegevensarchiefpad. Alleen ondersteund URI-type is azureml. Zie core yaml-syntaxis voor meer informatie over het gebruik van de azureml:// URI-indeling. Om te voorkomen dat er te veel schrijfbewerkingen worden uitgevoerd, wordt een uniek pad voor elke import aanbevolen. U doet dit door het pad te parameteriseren zoals wordt weergegeven in dit voorbeeld - azureml://datastores/<datastore_name>/paths/<source_name>/${{name}}. De 'datastore_name' in het voorbeeld kan een gegevensarchief zijn dat u hebt gemaakt of dat u workspaceblobstore kunt zijn. U kunt ook een 'beheerde gegevensopslag' selecteren door te verwijzen naar de volgende weergave: azureml://datastores/workspacemanagedstore, waarbij het systeem automatisch een uniek pad toewijst.		 Azure Machine Learning://<>
source object Externe brondetails van de geïmporteerde gegevensbron. Zie Kenmerken van de source set broneigenschappen.

Kenmerken van source (preview)

Sleutel Type Description Toegestane waarden Default value
type tekenreeks Het type externe bron waaruit u gegevens wilt importeren. Alleen de volgende typen zijn momenteel toegestaan - Database of FileSystem Database, FileSystem
query tekenreeks Definieer deze waarde alleen wanneer de type hierboven gedefinieerde query de query is database in de externe bron van het type Database waarmee gegevens worden gedefinieerd of gefilterd die moeten worden geïmporteerd.
path tekenreeks Definieer deze waarde alleen wanneer de type hierboven gedefinieerde map het mappad is FileSystem van de map in de externe bron van het type FileSystem waarin de bestanden of gegevens die moeten worden geïmporteerd, zich bevinden.
connection tekenreeks Vereist. De verbindingseigenschap voor de externe bron waarnaar wordt verwezen in de indeling van azureml:<connection_name>

Belangrijk

Deze functie is momenteel beschikbaar als openbare preview-versie. Deze preview-versie wordt geleverd zonder een service level agreement en we raden deze niet aan voor productieworkloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt.

Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews voor meer informatie.

Opmerkingen

De az ml schedule opdracht kan worden gebruikt voor het beheren van Azure Machine Learning-modellen.

Voorbeelden

Voorbeelden zijn beschikbaar in de GitHub-voorbeeldenopslagplaats. Hieronder ziet u een paar.

YAML: Plannen voor een gegevensimport met een terugkeerpatroon

VAN TOEPASSING OP: Azure CLI ml-extensie v2 (huidige)

YAML: Planning voor gegevensimport met terugkeerpatroon (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: Planning voor definitie van gegevensimport inline met terugkeerpatroon in beheerde gegevensopslag (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: Plannen voor een gegevensimport met cron-expressie

VAN TOEPASSING OP: Azure CLI ml-extensie v2 (huidige)

YAML: Planning voor het importeren van gegevens met cron-expressie (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: Planning voor definitie van gegevensimport inline met cron-expressie (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

Bijlage

Tijdzone

Het huidige schema ondersteunt de tijdzones in deze tabel. De sleutel kan rechtstreeks in de Python SDK worden gebruikt, terwijl de waarde kan worden gebruikt in de YAML voor het importeren van gegevens. De tabel wordt gesorteerd op UTC (Coordinated Universal Time).

UTC Sleutel Weergegeven als
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 "Hawaiiaanse standaardtijd"
UTC -09:30 MARQUESAS_STANDARD_TIME "Eenmalige tijd"
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 (Mexico)"
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 (Mexico)"
UTC -07:00 MOUNTAIN_STANDARD_TIME "Mountain Standard Time"
UTC -06:00 CENTRAL_AMERICA_STANDARD_TIME "Central America Standard Time"
UTC -06:00 CENTRAL_STANDARD_TIME "Centrale standaardtijd"
UTC -06:00 EASTER_ISLAND_STANDARD_TIME "Paaseiland Standaardtijd"
UTC -06:00 CENTRAL_STANDARD_TIME_MEXICO "Central Standard Time (Mexico)"
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 (Mexico)"
UTC -05:00 EASTERN_STANDARD_TIME "Eastern Standard Time"
UTC -05:00 HAITI_STANDARD_TIME "Haïti Standaardtijd"
UTC -05:00 CUBA_STANDARD_TIME "Cuba Standard Time"
UTC -05:00 US_EASTERN_STANDARD_TIME "US Eastern Standard Time"
UTC -05:00 TURKS_AND_CAICOS_STANDARD_TIME "Turks en Caicos Standaardtijd"
UTC -04:00 PARAGUAY_STANDARD_TIME "Paraguay Standard Time"
UTC -04:00 ATLANTIC_STANDARD_TIME "Atlantic Standard Time"
UTC -04:00 VENEZUELA_STANDARD_TIME "Venezuela Standard Time"
UTC -04:00 CENTRAL_BRAZILIAN_STANDARD_TIME "Centrale Braziliaanse standaardtijd"
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. Zuid-Amerika Standaardtijd"
UTC -03:00 SA_EASTERN_STANDARD_TIME "SA Eastern Standard Time"
UTC -03:00 ARGENTINA_STANDARD_TIME "Argentinië Standaardtijd"
UTC -03:00 GREENLAND_STANDARD_TIME "Groenland Standaardtijd"
UTC -03:00 MONTEVIDEO_STANDARD_TIME "Standaardtijd van De Stad"
UTC -03:00 SAINT_PIERRE_STANDARD_TIME "Saint Pierre Standard Time"
UTC -03:00 BAHIA_STANDARD_TIM "Standaardtijd Van Den 12012"
UTC -02:00 UTC_02 "UTC-02"
UTC -02:00 MID_ATLANTIC_STANDARD_TIME "Mid-Atlantic Standard Time"
UTC -01:00 AZORES_STANDARD_TIME "Azoren Standaardtijd"
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 "Greenwich Standard Time"
UTC +01:00 MOROCCO_STANDARD_TIME "Marokko Standaardtijd"
UTC +01:00 W_EUROPE_STANDARD_TIME "W. Europa Standaardtijd"
UTC +01:00 CENTRAL_EUROPE_STANDARD_TIME "Central Europe Standard Time"
UTC +01:00 ROMANCE_STANDARD_TIME "Romance Standard Time"
UTC +01:00 CENTRAL_EUROPEAN_STANDARD_TIME "Centraal-Europese standaardtijd"
UTC +01:00 W_CENTRAL_AFRICA_STANDARD_TIME "W. Central Africa Standard Time"
UTC +02:00 NAMIBIA_STANDARD_TIME "Namibië Standaardtijd"
UTC +02:00 JORDAN_STANDARD_TIME "Jordan Standard Time"
UTC +02:00 GTB_STANDARD_TIME "GTB Standaardtijd"
UTC +02:00 MIDDLE_EAST_STANDARD_TIME "Middle East Standard Time"
UTC +02:00 EGYPT_STANDARD_TIME "Egypte Standaardtijd"
UTC +02:00 E_EUROPE_STANDARD_TIME "E. Europa Standaardtijd"
UTC +02:00 SYRIA_STANDARD_TIME "Syrië Standard Time"
UTC +02:00 WEST_BANK_STANDARD_TIME "Westoever standaardtijd"
UTC +02:00 SOUTH_AFRICA_STANDARD_TIME "Zuid-Afrika Standaardtijd"
UTC +02:00 FLE_STANDARD_TIME "FLE-standaardtijd"
UTC +02:00 ISRAEL_STANDARD_TIME "Israël Standard Time"
UTC +02:00 KALININGRAD_STANDARD_TIME "Standaardtijd Van Den 12012"
UTC +02:00 LIBYA_STANDARD_TIME "Libische standaardtijd"
UTC +03:00 TÜRKIYE_STANDARD_TIME "Türktürk Standard Time"
UTC +03:00 ARABIC_STANDARD_TIME "Arabische standaardtijd"
UTC +03:00 ARAB_STANDARD_TIME "Arabische standaardtijd"
UTC +03:00 BELARUS_STANDARD_TIME "Wit-Rusland Standaardtijd"
UTC +03:00 RUSSIAN_STANDARD_TIME "Russische standaardtijd"
UTC +03:00 E_AFRICA_STANDARD_TIME "E. Afrika Standaardtijd"
UTC +03:30 IRAN_STANDARD_TIME "Iran Standard Time"
UTC +04:00 ARABIAN_STANDARD_TIME "Arabische standaardtijd"
UTC +04:00 ASTRAKHAN_STANDARD_TIME "Astra beweerd standaardtijd"
UTC +04:00 AZERBAIJAN_STANDARD_TIME "Azerbeidzjaans standaardtijd"
UTC +04:00 RUSSIA_TIME_ZONE_3 "Rusland Tijdzone 3"
UTC +04:00 MAURITIUS_STANDARD_TIME "Mauritiaanse standaardtijd"
UTC +04:00 GEORGIAN_STANDARD_TIME "Georgische standaardtijd"
UTC +04:00 CAUCASUS_STANDARD_TIME "Kaukasische standaardtijd"
UTC +04:30 AFGHANISTAN_STANDARD_TIME "Afghanistan Standard Time"
UTC +05:00 WEST_ASIA_STANDARD_TIME "West Asia Standard Time"
UTC +05:00 EKATERINBURG_STANDARD_TIME "Ekaterinburg Standaardtijd"
UTC +05:00 PAKISTAN_STANDARD_TIME "Pakistan Standard Time"
UTC +05:30 INDIA_STANDARD_TIME "India Standard Time"
UTC +05:30 SRI_LANKA_STANDARD_TIME "Sri Lanka Standard Time"
UTC +05:45 NEPAL_STANDARD_TIME "Nepal Standard Time"
UTC +06:00 CENTRAL_ASIA_STANDARD_TIME "Central Asia Standard Time"
UTC +06:00 BANGLADESH_STANDARD_TIME "Bangladesh Standard Time"
UTC +06:30 MYANMAR_STANDARD_TIME "Myanmar Standard Time"
UTC +07:00 N_CENTRAL_ASIA_STANDARD_TIME "N. Central Asia Standard Time"
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. Mongoolse standaardtijd"
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. Australië Standaardtijd"
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. Standaardtijd"
UTC +09:00 NORTH_KOREA_STANDARD_TIME "Noord-Korea Standaardtijd"
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 Standaardtijd"
UTC +09:30 CEN_AUSTRALIA_STANDARD_TIME "Cen. Australië Standaardtijd"
UTC +09:30 AUS_CENTRAL_STANDARD_TIME "AUS Central Standard Time"
UTC +10:00 E_AUSTRALIAN_STANDARD_TIME "E. Australië Standaardtijd"
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 "Tasmanië Standaardtijd"
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 "Rusland Tijdzone 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 "Rusland Tijdzone 11"
UTC +12:00 NEW_ZEALAND_STANDARD_TIME "Nieuw-Zeeland Standaardtijd"
UTC +12:00 UTC_12 "UTC+12"
UTC +12:00 FIJI_STANDARD_TIME "Standaardtijd van Fiji"
UTC +12:00 KAMCHATKA_STANDARD_TIME "Kamchatka Standaardtijd"
UTC +12:45 CHATHAM_ISLANDS_STANDARD_TIME "Chatham Islands Standard Time"
UTC +13:00 TONGA__STANDARD_TIME "Tonga Standaardtijd"
UTC +13:00 SAMOA_STANDARD_TIME "Samoa Standaardtijd"
UTC +14:00 LINE_ISLANDS_STANDARD_TIME "Standaardtijd lijneilanden"