Схема импорта YAML (версия 2)

ОБЛАСТЬ ПРИМЕНЕНИЯ: расширение машинного обучения Azure CLI версии 2 (текущее)

Исходную схему JSON можно найти по адресу https://azuremlschemas.azureedge.net/latest/schedule.schema.json.

Примечание.

Синтаксис YAML, описанный в этом документе, основан на схеме JSON для последней версии расширения ML CLI (версия 2). Этот синтаксис гарантированно работает только с последней версией расширения ML CLI (версия 2). Схемы для старых версий расширений можно найти по адресу https://azuremlschemasprod.azureedge.net/.

Синтаксис YAML

Ключ	Тип	Описание	Допустимые значения
$schema	строка	Схема YAML.
name	строка	Обязательный. Имя расписания.
description	строка	Описание расписания.
tags	объект	Словарь тегов для расписания.
trigger	объект	Конфигурация триггера для определения правила активации задания. Требуется одно из RecurrenceTrigger или CronTrigger.
import_data	Объект или строка	Обязательный. Определение действия импорта данных, активируемого расписанием. Требуется одно из string или ImportDataDefinition.

Конфигурация триггера

Триггер повторения

Ключ	Тип	Описание	Допустимые значения
type	строка	Обязательный. Указывает тип расписания.	повторение
frequency	строка	Обязательный. Указывает единицу времени, описывающую частоту срабатывания расписания.	minute, , hourday, weekmonth
interval	integer	Обязательный. Указывает интервал повторения расписания.
start_time	строка	Описывает дату и время начала с указанием часового пояса. Если start_time опущен, первое задание будет выполняться мгновенно, и будущий триггер заданий на основе расписания, заявив, что start_time будет соответствовать времени создания задания. Если время начала в прошлом, первое задание выполняется во время следующего вычисляемого выполнения.
end_time	строка	Описывает дату и время окончания с указанием часового пояса. Если end_time опущен, расписание выполняется до явного отключения.
timezone	строка	Указывает часовой пояс повторения. Если это значение отсутствует, по умолчанию задается время в формате UTC.	Значения времени в различных часовых поясах см. в приложении
pattern	объект	Указывает шаблон повторения. Если шаблон опущен, задания активируются в соответствии с логикой start_time, частоты и интервала.

Расписание повторений

Расписание повторений определяет шаблон повторения, содержащий hours, minutes и weekdays.

• Если параметру frequency задано значение day, в шаблоне можно указать hours и minutes.
• Если параметру frequency задано значение week и month, в шаблоне можно указать hours, minutes и weekdays.

Ключ	Тип	Допустимые значения
hours	целое число или массив целых чисел	0-23
minutes	целое число или массив целых чисел	0-59
week_days	строка или массив строк	monday, tuesday, wednesdaythursdayfridaysaturdaysunday

CronTrigger

Ключ	Тип	Описание	Допустимые значения
type	строка	Обязательный. Указывает тип расписания.	Cron
expression	строка	Обязательный. Задает выражение cron, определяющее способ активации заданий. В нем используется стандартное выражение crontab для выражения расписания повторений. Одно выражение состоит из пяти полей, разделенных пробелами: MINUTES HOURS DAYS MONTHS DAYS-OF-WEEK
start_time	строка	Описывает дату и время начала с указанием часового пояса. Если start_time опущен, первое задание будет выполняться мгновенно и триггер будущих заданий на основе расписания, заявив, что start_time будет соответствовать времени создания задания. Если время начала в прошлом, первое задание выполняется во время следующего вычисляемого выполнения.
end_time	строка	Описывает дату и время окончания с указанием часового пояса. Если end_time опущен, расписание продолжает выполняться до явного отключения.
timezone	строка	Указывает часовой пояс повторения. Если это значение отсутствует, по умолчанию задается время в формате UTC.	Значения времени в различных часовых поясах см. в приложении

Импорт определения данных (предварительная версия)

Внимание

Эта функция сейчас доступна в виде общедоступной предварительной версии. Эта предварительная версия предоставляется без соглашения об уровне обслуживания. Ее не следует использовать для производственных рабочих нагрузок. Некоторые функции могут не поддерживаться или их возможности могут быть ограничены.

Дополнительные сведения см. в статье Дополнительные условия использования Предварительных версий Microsoft Azure.

Клиент может напрямую использовать import_data: ./<data_import>.yaml или использовать следующие свойства для определения определения импорта данных.

Ключ	Тип	Описание	Допустимые значения
type	строка	Обязательный. Указывает тип ресурса данных, который требуется импортировать в качестве. Его можно использовать при импорте из источника базы данных или uri_folder при импорте из FileSource.	mltable, uri_folder
name	строка	Обязательный. Имя ресурса данных для регистрации импортированных данных.
path	строка	Обязательный. Путь к хранилищу данных, который принимает импортированные данные, указанный одним из двух способов: - Обязательно. Универсальный код ресурса (URI) пути хранилища данных. Поддерживается azuremlтолько тип универсального кода ресурса (URI). Дополнительные сведения об использовании формата URI azureml:// см. в статье Базовый синтаксис YAML. Чтобы избежать чрезмерной записи, рекомендуется использовать уникальный путь для каждого импорта. Для этого параметризируйте путь, как показано в этом примере. azureml://datastores/<datastore_name>/paths/<source_name>/${{name}} В примере "datastore_name" может быть хранилище данных, которое вы создали или может быть workspaceblobstore. Кроме того, можно выбрать управляемое хранилище данных, ссылаясь на следующее: azureml://datastores/workspacemanagedstoreгде система автоматически назначает уникальный путь.	Машинное обучение Azure://<>
source	объект	Внешний источник импортированного источника данных. См . атрибуты source набора исходных свойств.

source Атрибуты (предварительная версия)

Ключ	Тип	Описание	Допустимые значения	Default value
type	строка	Тип внешнего источника, из которого планируется импортировать данные. Только следующие типы разрешены в данный момент или DatabaseFileSystem	Database, FileSystem
query	строка	Определите это значение только в том случае, если указанный type выше запрос находится database во внешнем источнике типа Database , который определяет или фильтрует данные, которые необходимо импортировать.
path	строка	Определите это значение только в том случае, если type указанный выше FileSystem путь к папке в внешнем источнике типа FileSystem , где находятся файлы или данные, которые необходимо импортировать.
connection	строка	Обязательный. Свойство подключения для внешнего источника, на которое ссылается внешний источник в формате azureml:<connection_name>

Внимание

Эта функция сейчас доступна в виде общедоступной предварительной версии. Эта предварительная версия предоставляется без соглашения об уровне обслуживания. Ее не следует использовать для производственных рабочих нагрузок. Некоторые функции могут не поддерживаться или их возможности могут быть ограничены.

Дополнительные сведения см. в статье Дополнительные условия использования Предварительных версий Microsoft Azure.

Замечания

Команду az ml schedule можно использовать для управления моделями Машинного обучения Azure.

Примеры

Примеры доступны в репозитории примеров GitHub. Ниже представлены некоторые из них.

YAML: планирование импорта данных с шаблоном повторения

ОБЛАСТЬ ПРИМЕНЕНИЯ: расширение машинного обучения Azure CLI версии 2 (текущее)

YAML: планирование импорта данных с шаблоном повторения (предварительная версия)

$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: планирование определения импорта данных в соответствии с шаблоном повторения в управляемом хранилище данных (предварительная версия)

$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: планирование импорта данных с помощью выражения cron

ОБЛАСТЬ ПРИМЕНЕНИЯ: расширение машинного обучения Azure CLI версии 2 (текущее)

YAML: планирование импорта данных с помощью выражения cron (предварительная версия)

$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: планирование определения импорта данных в соответствии с выражением cron (предварительная версия)

$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

Приложение

Часовой пояс

Текущее расписание поддерживает часовые пояса в этой таблице. Ключ можно использовать непосредственно в пакете SDK для Python, а значение можно использовать в импорте данных YAML. Таблица отсортирована по utc (координированное универсальное время).

UTC	Ключ	Значение
UTC –12:00	DATELINE_STANDARD_TIME	"Линия перемены дат"
UTC –11:00	UTC_11	"UTC–11"
UTC –10:00	ALEUTIAN_STANDARD_TIME	Алеутские острова (зима)
UTC –10:00	HAWAIIAN_STANDARD_TIME	"Гавайское стандартное время"
UTC –09:30	MARQUESAS_STANDARD_TIME	"Маркизские острова"
UTC –09:00	ALASKAN_STANDARD_TIME	"Аляскинское стандартное время"
UTC –09:00	UTC_09	"UTC–09"
UTC –08:00	PACIFIC_STANDARD_TIME_MEXICO	"Тихоокеанское стандартное время (Мексика)"
UTC –08:00	UTC_08	"UTC–08"
UTC –08:00	PACIFIC_STANDARD_TIME	"Североамериканское тихоокеанское время"
UTC -07:00	US_MOUNTAIN_STANDARD_TIME	"Горное время (США)"
UTC -07:00	MOUNTAIN_STANDARD_TIME_MEXICO	"Горное время (Мексика)"
UTC -07:00	MOUNTAIN_STANDARD_TIME	"Горное стандартное время"
UTC –06:00	CENTRAL_AMERICA_STANDARD_TIME	"Центральноамериканское время"
UTC –06:00	CENTRAL_STANDARD_TIME	"Центральное стандартное время"
UTC –06:00	EASTER_ISLAND_STANDARD_TIME	"Стандартное время (остров Пасхи)"
UTC –06:00	CENTRAL_STANDARD_TIME_MEXICO	"Центральное стандартное время (Мексика)"
UTC –06:00	CANADA_CENTRAL_STANDARD_TIME	"Центральное стандартное время (Канада)"
UTC –05:00	SA_PACIFIC_STANDARD_TIME	"Южноамериканское тихоокеанское время"
UTC –05:00	EASTERN_STANDARD_TIME_MEXICO	"Восточное стандартное время (Мексика)"
UTC –05:00	EASTERN_STANDARD_TIME	"Восточное стандартное время"
UTC –05:00	HAITI_STANDARD_TIME	"Стандартное время (Гаити)"
UTC –05:00	CUBA_STANDARD_TIME	"Стандартное время (Куба)"
UTC –05:00	US_EASTERN_STANDARD_TIME	"Восточное стандартное время (США)"
UTC –05:00	TURKS_AND_CAICOS_STANDARD_TIME	"Стандартное время (острова Теркс и Кайкос)"
UTC –04:00	PARAGUAY_STANDARD_TIME	"Стандартное время (Парагвай)"
UTC –04:00	ATLANTIC_STANDARD_TIME	"Атлантическое стандартное время"
UTC –04:00	VENEZUELA_STANDARD_TIME	"Стандартное время (Венесуэла)"
UTC –04:00	CENTRAL_BRAZILIAN_STANDARD_TIME	"Стандартное время (Центральная Бразилия)"
UTC –04:00	SA_WESTERN_STANDARD_TIME	"Южноамериканское западное стандартное время"
UTC –04:00	PACIFIC_SA_STANDARD_TIME	"Южноамериканское тихоокеанское стандартное время"
UTC –03:30	NEWFOUNDLAND_STANDARD_TIME	"Стандартное время (Ньюфаундленд)"
UTC –03:00	TOCANTINS_STANDARD_TIME	"Стандартное время (Токантинс)"
UTC –03:00	E_SOUTH_AMERICAN_STANDARD_TIME	"E. южноамериканское стандартное время"
UTC –03:00	SA_EASTERN_STANDARD_TIME	"Южноамериканское восточное стандартное время"
UTC –03:00	ARGENTINA_STANDARD_TIME	"Стандартное время (Аргентина)"
UTC –03:00	GREENLAND_STANDARD_TIME	"Стандартное время (Гренландия)"
UTC –03:00	MONTEVIDEO_STANDARD_TIME	"Стандартное время (Монтевидео)"
UTC –03:00	SAINT_PIERRE_STANDARD_TIME	"Стандартное время (Сен-Пьер)"
UTC –03:00	BAHIA_STANDARD_TIM	"Стандартное время (Баия)"
UTC –02:00	UTC_02	"UTC–02"
UTC –02:00	MID_ATLANTIC_STANDARD_TIME	"Среднеатлантическое стандартное время"
UTC –01:00	AZORES_STANDARD_TIME	"Стандартное время (Азорские острова)"
UTC –01:00	CAPE_VERDE_STANDARD_TIME	"Стандартное время (Кабо-Верде)"
UTC	UTC	UTC
UTC +00:00	GMT_STANDARD_TIME	"Среднее время по Гринвичу"
UTC +00:00	GREENWICH_STANDARD_TIME	"Стандартное время по Гринвичу"
UTC +01:00	MOROCCO_STANDARD_TIME	"Стандартное время (Марокко)"
UTC +01:00	W_EUROPE_STANDARD_TIME	"Западноевропейское стандартное время"
UTC +01:00	CENTRAL_EUROPE_STANDARD_TIME	"Центральноевропейское стандартное время"
UTC +01:00	ROMANCE_STANDARD_TIME	"Романское стандартное время"
UTC +01:00	CENTRAL_EUROPEAN_STANDARD_TIME	"Центральноевропейское стандартное время"
UTC +01:00	W_CENTRAL_AFRICA_STANDARD_TIME	"Западноевропейское стандартное время"
UTC+02:00	NAMIBIA_STANDARD_TIME	"Стандартное время (Намибия)"
UTC+02:00	JORDAN_STANDARD_TIME	"Стандартное время (Иордания)"
UTC+02:00	GTB_STANDARD_TIME	"Стандартное время (Греция, Турция, Болгария)"
UTC+02:00	MIDDLE_EAST_STANDARD_TIME	"Стандартное время (Ближний Восток)"
UTC+02:00	EGYPT_STANDARD_TIME	"Стандартное время (Египет)"
UTC+02:00	E_EUROPE_STANDARD_TIME	"E. стандартное время"
UTC+02:00	SYRIA_STANDARD_TIME	"Стандартное время (Сирия)"
UTC+02:00	WEST_BANK_STANDARD_TIME	"Стандартное время (Западный берег реки Иордан)"
UTC+02:00	SOUTH_AFRICA_STANDARD_TIME	"Южноафриканское стандартное время"
UTC+02:00	FLE_STANDARD_TIME	"Стандартное время (Финляндия, Литва, Эстония)"
UTC+02:00	ISRAEL_STANDARD_TIME	"Стандартное время (Израиль)"
UTC+02:00	KALININGRAD_STANDARD_TIME	"Стандартное время (Калининград)"
UTC+02:00	LIBYA_STANDARD_TIME	"Стандартное время (Ливия)"
UTC +03:00	TÜRKIYE_STANDARD_TIME	"Türkiye Standard Time"
UTC +03:00	ARABIC_STANDARD_TIME	"Стандартное время (Средний Восток)"
UTC +03:00	ARAB_STANDARD_TIME	"Стандартное время (ОАЭ)"
UTC +03:00	BELARUS_STANDARD_TIME	"Стандартное время (Беларусь)"
UTC +03:00	RUSSIAN_STANDARD_TIME	"Стандартное время (Россия)"
UTC +03:00	E_AFRICA_STANDARD_TIME	"E. стандартное время"
UTC +03:30	IRAN_STANDARD_TIME	"Стандартное время (Иран)"
UTC +04:00	ARABIAN_STANDARD_TIME	"Стандартное время (Саудовская Аравия)"
UTC +04:00	ASTRAKHAN_STANDARD_TIME	"Стандартное время (Астрахань)"
UTC +04:00	AZERBAIJAN_STANDARD_TIME	"Стандартное время (Азербайджан)"
UTC +04:00	RUSSIA_TIME_ZONE_3	"Россия, часовой пояс 3"
UTC +04:00	MAURITIUS_STANDARD_TIME	"Стандартное время (Маврикий)"
UTC +04:00	GEORGIAN_STANDARD_TIME	"Стандартное время (Грузия)"
UTC +04:00	CAUCASUS_STANDARD_TIME	"Стандартное время (Северный Кавказ)"
UTC +04:30	AFGHANISTAN_STANDARD_TIME	"Стандартное время (Афганистан)"
UTC +05:00	WEST_ASIA_STANDARD_TIME	"Западноазиатское стандартное время"
UTC +05:00	EKATERINBURG_STANDARD_TIME	"Стандартное время (Екатеринбург)"
UTC +05:00	PAKISTAN_STANDARD_TIME	"Стандартное время (Пакистан)"
UTC +05:30	INDIA_STANDARD_TIME	"Стандартное время (Индия)"
UTC +05:30	SRI_LANKA_STANDARD_TIME	"Стандартное время (Шри-Ланка)"
UTC +05:45	NEPAL_STANDARD_TIME	"Стандартное время (Непал)"
UTC +06:00	CENTRAL_ASIA_STANDARD_TIME	"Центральноазиатское стандартное время"
UTC +06:00	BANGLADESH_STANDARD_TIME	"Стандартное время (Бангладеш)"
UTC +06:30	MYANMAR_STANDARD_TIME	"Стандартное время (Мьянма)"
UTC +07:00	N_CENTRAL_ASIA_STANDARD_TIME	"Стандартное время (Северно-Центральная Азия)"
UTC +07:00	SE_ASIA_STANDARD_TIME	"Стандартное время (Юго-Восточная Азия)"
UTC +07:00	ALTAI_STANDARD_TIME	"Стандартное время (Алтай)"
UTC +07:00	W_MONGOLIA_STANDARD_TIME	"Западноевропейское время (Западная Монголия)"
UTC +07:00	NORTH_ASIA_STANDARD_TIME	"Североазиатское стандартное время"
UTC +07:00	TOMSK_STANDARD_TIME	"Стандартное время (Томск)"
UTC +08:00	CHINA_STANDARD_TIME	"Стандартное время (Китай)"
UTC +08:00	NORTH_ASIA_EAST_STANDARD_TIME	"Стандартное время (Северо-Восточная Азия)"
UTC +08:00	SINGAPORE_STANDARD_TIME	"Стандартное время (Сингапур)"
UTC +08:00	W_AUSTRALIA_STANDARD_TIME	"Западноевропейское стандартное время"
UTC +08:00	TAIPEI_STANDARD_TIME	"Стандартное время (Тайбэй)"
UTC +08:00	ULAANBAATAR_STANDARD_TIME	"Стандартное время (Улан-Батор)"
UTC +08:45	AUS_CENTRAL_W_STANDARD_TIME	"Стандартное время (Центрально-западная Австралия)"
UTC +09:00	NORTH_KOREA_STANDARD_TIME	"Стандартное время (Северная Корея)"
UTC +09:00	TRANSBAIKAL_STANDARD_TIME	"Стандартное время (Забайкалье)"
UTC +09:00	TOKYO_STANDARD_TIME	"Стандартное время (Токио)"
UTC +09:00	KOREA_STANDARD_TIME	"Стандартное время (Корея)"
UTC +09:00	YAKUTSK_STANDARD_TIME	"Стандартное время (Якутск)"
UTC +09:30	CEN_AUSTRALIA_STANDARD_TIME	"Центральноавстралийское стандартное время"
UTC +09:30	AUS_CENTRAL_STANDARD_TIME	"Центральноавстралийское стандартное время"
UTC +10:00	E_AUSTRALIAN_STANDARD_TIME	"E. стандартное время"
UTC +10:00	AUS_EASTERN_STANDARD_TIME	"Восточноавстралийское стандартное время"
UTC +10:00	WEST_PACIFIC_STANDARD_TIME	"Западно-тихоокеанское стандартное время"
UTC +10:00	TASMANIA_STANDARD_TIME	"Стандартное время (Тасмания)"
UTC +10:00	VLADIVOSTOK_STANDARD_TIME	"Стандартное время (Владивосток)"
UTC +10:30	LORD_HOWE_STANDARD_TIME	"Стандартное время (Лорд-Хау)"
UTC +11:00	BOUGAINVILLE_STANDARD_TIME	"Стандартное время (Бугенвиль)"
UTC +11:00	RUSSIA_TIME_ZONE_10	"Россия, часовой пояс 10"
UTC +11:00	MAGADAN_STANDARD_TIME	"Стандартное время (Магадан)"
UTC +11:00	NORFOLK_STANDARD_TIME	"Стандартное время (Норфолк)"
UTC +11:00	SAKHALIN_STANDARD_TIME	"Стандартное время (Сахалин)"
UTC +11:00	CENTRAL_PACIFIC_STANDARD_TIME	"Центрально-тихоокеанское стандартное время"
UTC +12:00	RUSSIA_TIME_ZONE_11	"Россия, часовой пояс 11"
UTC +12:00	NEW_ZEALAND_STANDARD_TIME	"Стандартное время (Новая Зеландия)"
UTC +12:00	UTC_12	"UTC+12"
UTC +12:00	FIJI_STANDARD_TIME	"Стандартное время (Фиджи)"
UTC +12:00	KAMCHATKA_STANDARD_TIME	"Стандартное время (Камчатка)"
UTC +12:45	CHATHAM_ISLANDS_STANDARD_TIME	"Стандартное время (острова Чатем)"
UTC +13:00	TONGA__STANDARD_TIME	"Стандартное время (Тонга)"
UTC +13:00	SAMOA_STANDARD_TIME	"Стандартное время (Самоа)"
UTC +14:00	LINE_ISLANDS_STANDARD_TIME	"Стандартное время (острова Лайн)"