Схема импорта 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 , , hour day , week month |
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 , wednesday thursday friday saturday sunday |
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 |
строка | Тип внешнего источника, из которого планируется импортировать данные. Только следующие типы разрешены в данный момент или Database FileSystem |
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 | "Стандартное время (острова Лайн)" |