Поделиться через


Схема импорта 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 "Стандартное время (острова Лайн)"