Partilhar via

Esquema YAML de agendamento de importação CLI (v2)

  • Artigo

APLICA-SE A:Extensão ml da CLI do Azure v2 (atual)

O esquema JSON de origem pode ser encontrado em https://azuremlschemas.azureedge.net/latest/schedule.schema.json.

Nota

A sintaxe YAML detalhada neste documento é baseada no esquema JSON para a versão mais recente da extensão ML CLI v2. Esta sintaxe é garantida apenas para funcionar com a versão mais recente da extensão ML CLI v2. Você pode encontrar os esquemas para versões de extensão mais antigas em https://azuremlschemasprod.azureedge.net/.

Sintaxe YAML

Key Tipo Description Valores permitidos
$schema string O esquema YAML.
name string Obrigatório. Nome da agenda.
description string Descrição do horário.
tags objeto Dicionário de tags para o horário.
trigger objeto A configuração de gatilho para definir a regra quando acionar o trabalho. Um dos RecurrenceTrigger ou CronTrigger é obrigatório.
import_data objeto ou cadeia de caracteres Obrigatório. A definição da ação de importação de dados que uma agenda disparou. Um dos string ou ImportDataDefinition é obrigatório.

Configuração do acionador

Acionador de periodicidade

Key Tipo Description Valores permitidos
type string Obrigatório. Especifica o tipo de agenda. recurrence
frequency string Obrigatório. Especifica a unidade de tempo que descreve a frequência com que a agenda é acionada. minute, , , , hourdayweekmonth
interval integer Obrigatório. Especifica o intervalo no qual a agenda é acionada.
start_time string Descreve a data e hora de início com fuso horário. Se start_time for omitido, o primeiro trabalho será executado instantaneamente e os trabalhos futuros serão acionados com base no cronograma, dizendo start_time corresponderá ao tempo de trabalho criado. Se a hora de início estiver no passado, o primeiro trabalho será executado no próximo tempo de execução calculado.
end_time string Descreve a data e hora de término com fuso horário. Se end_time for omitido, a agenda será executada até ser explicitamente desativada.
timezone string Especifica o fuso horário da recorrência. Se omitido, por padrão é UTC. Consulte o apêndice para valores de fuso horário
pattern objeto Especifica o padrão da recorrência. Se o padrão for omitido, o(s) trabalho(s) é(são) acionado(s) de acordo com a lógica de start_time, frequência e intervalo.

Esquema de recorrência

O esquema de recorrência define o padrão de recorrência, contendo hours, minutese weekdays.

  • Quando a frequência é day, o padrão pode especificar hours e minutes.
  • Quando a frequência é week e month, o padrão pode especificar hours, minutes e weekdays.
Key Tipo Valores permitidos
hours inteiro ou matriz de inteiro 0-23
minutes inteiro ou matriz de inteiro 0-59
week_days string ou matriz de string monday, , , , , saturday, tuesdaywednesdaythursdayfridaysunday

CronTrigger

Key Tipo Description Valores permitidos
type string Obrigatório. Especifica o tipo de agenda. cron
expression string Obrigatório. Especifica a expressão cron para definir como disparar trabalhos. expression usa a expressão crontab padrão para expressar uma agenda recorrente. Uma única expressão é composta por cinco campos delimitados por espaço:MINUTES HOURS DAYS MONTHS DAYS-OF-WEEK
start_time string Descreve a data e hora de início com fuso horário. Se start_time for omitido, o primeiro trabalho será executado instantaneamente e os trabalhos futuros serão acionados com base no cronograma, dizendo start_time corresponderá ao tempo de trabalho criado. Se a hora de início estiver no passado, o primeiro trabalho será executado no próximo tempo de execução calculado.
end_time string Descreve a data e hora de término com fuso horário. Se end_time for omitido, a agenda continuará a ser executada até ser explicitamente desativada.
timezone string Especifica o fuso horário da recorrência. Se omitido, por padrão é UTC. Consulte o apêndice para valores de fuso horário

Importar definição de dados (visualização)

Importante

Esta funcionalidade está atualmente em pré-visualização pública. Esta versão de pré-visualização é fornecida sem um contrato de nível de serviço e não a recomendamos para cargas de trabalho de produção. Algumas funcionalidades poderão não ser suportadas ou poderão ter capacidades limitadas.

Para obter mais informações, veja Termos Suplementares de Utilização para Pré-visualizações do Microsoft Azure.

O cliente pode usar diretamente ou pode usar import_data: ./<data_import>.yaml as seguintes propriedades para definir a definição de importação de dados.

Key Tipo Description Valores permitidos
type string Obrigatório. Especifica o tipo de ativo de dados para o qual você deseja importar os dados. Ele pode ser mltable ao importar de uma fonte de banco de dados ou uri_folder ao importar de um FileSource. mltable, uri_folder
name string Obrigatório. Nome do ativo de dados para registrar os dados importados.
path string Obrigatório. O caminho para o armazenamento de dados que recebe os dados importados, especificado de duas maneiras:

- Necessário. Um URI do caminho do armazenamento de dados. Apenas o tipo de URI suportado é azureml. Para obter mais informações sobre como usar o azureml:// formato URI, consulte Sintaxe yaml principal. Para evitar uma sobregravação, recomenda-se um caminho exclusivo para cada importação. Para fazer isso, parametrize o caminho como mostrado neste exemplo - azureml://datastores/<datastore_name>/paths/<source_name>/${{name}}. O "datastore_name" no exemplo pode ser um armazenamento de dados que você criou ou pode ser workspaceblobstore. Como alternativa, um "armazenamento de dados gerenciado" pode ser selecionado fazendo referência como mostrado: azureml://datastores/workspacemanagedstore, onde o sistema atribui automaticamente um caminho exclusivo.		 Azure Machine Learning://<>
source objeto Detalhes da fonte externa da fonte de dados importada. Consulte Atributos do source para o conjunto de propriedades de origem.

Atributos de source (visualização)

Key Tipo Description Valores permitidos Default value
type string O tipo de fonte externa de onde você pretende importar dados. Apenas os seguintes tipos são permitidos no momento - Database ou FileSystem Database, FileSystem
query string Defina esse valor somente quando o type definido acima for database A consulta na fonte externa do tipo Database que define ou filtra dados que precisam ser importados.
path string Defina esse valor somente quando o definido acima for FileSystem O caminho da pasta na fonte externa do tipo FileSystem onde residem otype(s) arquivo(s) ou os dados que precisam ser importados.
connection string Obrigatório. A propriedade de conexão para a fonte externa referenciada no formato de azureml:<connection_name>

Importante

Esta funcionalidade está atualmente em pré-visualização pública. Esta versão de pré-visualização é fornecida sem um contrato de nível de serviço e não a recomendamos para cargas de trabalho de produção. Algumas funcionalidades poderão não ser suportadas ou poderão ter capacidades limitadas.

Para obter mais informações, veja Termos Suplementares de Utilização para Pré-visualizações do Microsoft Azure.

Observações

O az ml schedule comando pode ser usado para gerenciar modelos do Azure Machine Learning.

Exemplos

Exemplos estão disponíveis no repositório GitHub de exemplos. Um casal é mostrado abaixo.

YAML: Agendamento para uma importação de dados com padrão de recorrência

APLICA-SE A:Extensão ml da CLI do Azure v2 (atual)

YAML: Agendamento para importação de dados com padrão de recorrência (visualização)

$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: Agendamento para definição de importação de dados em linha com o padrão de recorrência no armazenamento de dados gerenciado (visualização)

$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: Agendar uma importação de dados com expressão cron

APLICA-SE A:Extensão ml da CLI do Azure v2 (atual)

YAML: Agendamento para importação de dados com expressão cron (visualização)

$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: Agendamento para definição de importação de dados em linha com expressão cron (visualização)

$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

Anexo

Fuso horário

A programação atual suporta os fusos horários nesta tabela. A chave pode ser usada diretamente no Python SDK, enquanto o valor pode ser usado na importação de dados YAML. A tabela é ordenada por UTC (Tempo Universal Coordenado).

UTC Key valor
UTC -12:00 DATELINE_STANDARD_TIME "Hora padrão da linha de data"
UTC -11:00 UTC_11 "UTC-11"
UTC - 10:00 ALEUTIAN_STANDARD_TIME Hora Padrão Aleuta
UTC - 10:00 HAWAIIAN_STANDARD_TIME "Hora padrão havaiana"
UTC -09:30 MARQUESAS_STANDARD_TIME "Hora Padrão das Marquesas"
UTC -09:00 ALASKAN_STANDARD_TIME "Hora Padrão do Alasca"
UTC -09:00 UTC_09 "UTC-09"
UTC -08:00 PACIFIC_STANDARD_TIME_MEXICO "Hora Padrão do Pacífico (México)"
UTC -08:00 UTC_08 "UTC-08"
UTC -08:00 PACIFIC_STANDARD_TIME "Hora Padrão do Pacífico"
UTC -07:00 US_MOUNTAIN_STANDARD_TIME "Hora Padrão da Montanha dos EUA"
UTC -07:00 MOUNTAIN_STANDARD_TIME_MEXICO "Hora Padrão da Montanha (México)"
UTC -07:00 MOUNTAIN_STANDARD_TIME "Hora Padrão da Montanha"
UTC -06:00 CENTRAL_AMERICA_STANDARD_TIME "Hora Padrão da América Central"
UTC -06:00 CENTRAL_STANDARD_TIME "Hora Padrão Central"
UTC -06:00 EASTER_ISLAND_STANDARD_TIME "Hora Padrão da Ilha de Páscoa"
UTC -06:00 CENTRAL_STANDARD_TIME_MEXICO "Hora Padrão Central (México)"
UTC -06:00 CANADA_CENTRAL_STANDARD_TIME "Hora Padrão Central do Canadá"
UTC -05:00 SA_PACIFIC_STANDARD_TIME "Hora Padrão do Pacífico SA"
UTC -05:00 EASTERN_STANDARD_TIME_MEXICO "Hora Padrão do Leste (México)"
UTC -05:00 EASTERN_STANDARD_TIME "Hora Padrão do Leste"
UTC -05:00 HAITI_STANDARD_TIME "Hora Padrão do Haiti"
UTC -05:00 CUBA_STANDARD_TIME "Hora Padrão de Cuba"
UTC -05:00 US_EASTERN_STANDARD_TIME "Hora Padrão do Leste dos EUA"
UTC -05:00 TURKS_AND_CAICOS_STANDARD_TIME "Hora Padrão de Turks e Caicos"
UTC -04:00 PARAGUAY_STANDARD_TIME "Hora Padrão do Paraguai"
UTC -04:00 ATLANTIC_STANDARD_TIME "Hora Padrão do Atlântico"
UTC -04:00 VENEZUELA_STANDARD_TIME "Hora Padrão da Venezuela"
UTC -04:00 CENTRAL_BRAZILIAN_STANDARD_TIME "Hora Padrão Central Brasileira"
UTC -04:00 SA_WESTERN_STANDARD_TIME "Hora Padrão Ocidental SA"
UTC -04:00 PACIFIC_SA_STANDARD_TIME "Hora Padrão Pacific SA"
UTC -03:30 NEWFOUNDLAND_STANDARD_TIME "Hora Padrão da Terra Nova"
UTC -03:00 TOCANTINS_STANDARD_TIME "Hora Padrão do Tocantins"
UTC -03:00 E_SOUTH_AMERICAN_STANDARD_TIME "E. Hora Padrão da América do Sul"
UTC -03:00 SA_EASTERN_STANDARD_TIME "SA Hora Padrão do Leste"
UTC -03:00 ARGENTINA_STANDARD_TIME "Hora Padrão Argentina"
UTC -03:00 GREENLAND_STANDARD_TIME "Hora padrão da Gronelândia"
UTC -03:00 MONTEVIDEO_STANDARD_TIME "Hora Padrão de Montevidéu"
UTC -03:00 SAINT_PIERRE_STANDARD_TIME "Hora Padrão de São Pierre"
UTC -03:00 BAHIA_STANDARD_TIM "Hora Padrão da Bahia"
UTC -02:00 UTC_02 "UTC-02"
UTC -02:00 MID_ATLANTIC_STANDARD_TIME "Hora Padrão do Atlântico Médio"
UTC -01:00 AZORES_STANDARD_TIME "Hora Padrão dos Açores"
UTC -01:00 CAPE_VERDE_STANDARD_TIME "Hora Padrão de Cabo Verde"
UTC UTC UTC
UTC +00:00 GMT_STANDARD_TIME "Hora padrão GMT"
UTC +00:00 GREENWICH_STANDARD_TIME "Hora Padrão de Greenwich"
UTC +01:00 MOROCCO_STANDARD_TIME "Hora Padrão de Marrocos"
UTC +01:00 W_EUROPE_STANDARD_TIME "W. Hora Padrão da Europa"
UTC +01:00 CENTRAL_EUROPE_STANDARD_TIME "Hora Padrão da Europa Central"
UTC +01:00 ROMANCE_STANDARD_TIME "Hora padrão do romance"
UTC +01:00 CENTRAL_EUROPEAN_STANDARD_TIME "Hora Padrão da Europa Central"
UTC +01:00 W_CENTRAL_AFRICA_STANDARD_TIME "W. Hora Padrão da África Central"
UTC +02:00 NAMIBIA_STANDARD_TIME "Hora Padrão da Namíbia"
UTC +02:00 JORDAN_STANDARD_TIME "Hora padrão da Jordânia"
UTC +02:00 GTB_STANDARD_TIME "Hora Padrão GTB"
UTC +02:00 MIDDLE_EAST_STANDARD_TIME "Hora Padrão do Médio Oriente"
UTC +02:00 EGYPT_STANDARD_TIME "Hora Padrão do Egito"
UTC +02:00 E_EUROPE_STANDARD_TIME "E. Hora Padrão da Europa"
UTC +02:00 SYRIA_STANDARD_TIME "Hora padrão da Síria"
UTC +02:00 WEST_BANK_STANDARD_TIME "Hora padrão da Cisjordânia"
UTC +02:00 SOUTH_AFRICA_STANDARD_TIME "Hora Padrão da África do Sul"
UTC +02:00 FLE_STANDARD_TIME "Hora Padrão FLE"
UTC +02:00 ISRAEL_STANDARD_TIME "Hora Padrão de Israel"
UTC +02:00 KALININGRAD_STANDARD_TIME "Hora padrão de Kaliningrado"
UTC +02:00 LIBYA_STANDARD_TIME "Hora padrão da Líbia"
UTC +03:00 TÜRKIYE_STANDARD_TIME "Hora Padrão de Türkiye"
UTC +03:00 ARABIC_STANDARD_TIME "Hora padrão árabe"
UTC +03:00 ARAB_STANDARD_TIME "Hora Padrão Árabe"
UTC +03:00 BELARUS_STANDARD_TIME "Hora Padrão da Bielorrússia"
UTC +03:00 RUSSIAN_STANDARD_TIME "Hora padrão russa"
UTC +03:00 E_AFRICA_STANDARD_TIME "E. Hora Padrão de África"
UTC +03:30 IRAN_STANDARD_TIME "Hora Padrão do Irão"
UTC +04:00 ARABIAN_STANDARD_TIME "Hora padrão árabe"
UTC +04:00 ASTRAKHAN_STANDARD_TIME "Hora Padrão de Astrakhan"
UTC +04:00 AZERBAIJAN_STANDARD_TIME "Hora Padrão do Azerbaijão"
UTC +04:00 RUSSIA_TIME_ZONE_3 "Rússia Fuso horário 3"
UTC +04:00 MAURITIUS_STANDARD_TIME "Hora Padrão das Maurícias"
UTC +04:00 GEORGIAN_STANDARD_TIME "Hora padrão da Geórgia"
UTC +04:00 CAUCASUS_STANDARD_TIME "Hora padrão do Cáucaso"
UTC +04:30 AFGHANISTAN_STANDARD_TIME "Hora padrão do Afeganistão"
UTC +05:00 WEST_ASIA_STANDARD_TIME "Hora Padrão da Ásia Ocidental"
UTC +05:00 EKATERINBURG_STANDARD_TIME "Hora Padrão de Ekaterinburg"
UTC +05:00 PAKISTAN_STANDARD_TIME "Hora Padrão do Paquistão"
UTC +05:30 INDIA_STANDARD_TIME "Hora Padrão da Índia"
UTC +05:30 SRI_LANKA_STANDARD_TIME "Hora Padrão do Sri Lanka"
UTC +05:45 NEPAL_STANDARD_TIME "Hora Padrão do Nepal"
UTC +06:00 CENTRAL_ASIA_STANDARD_TIME "Hora Padrão da Ásia Central"
UTC +06:00 BANGLADESH_STANDARD_TIME "Hora padrão de Bangladesh"
UTC +06:30 MYANMAR_STANDARD_TIME "Hora Padrão de Mianmar"
UTC +07:00 N_CENTRAL_ASIA_STANDARD_TIME "Não. Hora Padrão da Ásia Central"
UTC +07:00 SE_ASIA_STANDARD_TIME "Hora Padrão SE Ásia"
UTC +07:00 ALTAI_STANDARD_TIME "Hora padrão de Altai"
UTC +07:00 W_MONGOLIA_STANDARD_TIME "W. Hora Padrão da Mongólia"
UTC +07:00 NORTH_ASIA_STANDARD_TIME "Hora Padrão do Norte da Ásia"
UTC +07:00 TOMSK_STANDARD_TIME "Hora padrão de Tomsk"
UTC +08:00 CHINA_STANDARD_TIME "Hora Padrão da China"
UTC +08:00 NORTH_ASIA_EAST_STANDARD_TIME "Hora Padrão do Leste da Ásia do Norte"
UTC +08:00 SINGAPORE_STANDARD_TIME "Hora Padrão de Singapura"
UTC +08:00 W_AUSTRALIA_STANDARD_TIME "W. Hora Padrão da Austrália"
UTC +08:00 TAIPEI_STANDARD_TIME "Hora Padrão de Taipei"
UTC +08:00 ULAANBAATAR_STANDARD_TIME "Hora Padrão de Ulaanbaatar"
UTC +08:45 AUS_CENTRAL_W_STANDARD_TIME "Aus Central W. Hora Padrão"
UTC +09:00 NORTH_KOREA_STANDARD_TIME "Hora padrão da Coreia do Norte"
UTC +09:00 TRANSBAIKAL_STANDARD_TIME "Hora Padrão Transbaikal"
UTC +09:00 TOKYO_STANDARD_TIME "Hora Padrão de Tóquio"
UTC +09:00 KOREA_STANDARD_TIME "Hora Padrão da Coreia"
UTC +09:00 YAKUTSK_STANDARD_TIME "Hora padrão de Yakutsk"
UTC +09:30 CEN_AUSTRALIA_STANDARD_TIME "Cen. Hora Padrão da Austrália"
UTC +09:30 AUS_CENTRAL_STANDARD_TIME "Hora Padrão Central AUS"
UTC +10:00 E_AUSTRALIAN_STANDARD_TIME "E. Hora Padrão da Austrália"
UTC +10:00 AUS_EASTERN_STANDARD_TIME "AUS Hora Padrão do Leste"
UTC +10:00 WEST_PACIFIC_STANDARD_TIME "Hora Padrão do Pacífico Oeste"
UTC +10:00 TASMANIA_STANDARD_TIME "Hora Padrão da Tasmânia"
UTC +10:00 VLADIVOSTOK_STANDARD_TIME "Hora Padrão de Vladivostok"
UTC +10:30 LORD_HOWE_STANDARD_TIME "Hora Padrão de Lord Howe"
UTC +11:00 BOUGAINVILLE_STANDARD_TIME "Hora Padrão de Bougainville"
UTC +11:00 RUSSIA_TIME_ZONE_10 "Rússia Fuso horário 10"
UTC +11:00 MAGADAN_STANDARD_TIME "Hora Padrão de Magadan"
UTC +11:00 NORFOLK_STANDARD_TIME "Hora Padrão de Norfolk"
UTC +11:00 SAKHALIN_STANDARD_TIME "Hora Padrão de Sacalina"
UTC +11:00 CENTRAL_PACIFIC_STANDARD_TIME "Hora Padrão do Pacífico Central"
UTC +12:00 RUSSIA_TIME_ZONE_11 "Rússia Fuso horário 11"
UTC +12:00 NEW_ZEALAND_STANDARD_TIME "Hora Padrão da Nova Zelândia"
UTC +12:00 UTC_12 "UTC+12"
UTC +12:00 FIJI_STANDARD_TIME "Hora padrão de Fiji"
UTC +12:00 KAMCHATKA_STANDARD_TIME "Hora Padrão de Kamchatka"
UTC +12:45 CHATHAM_ISLANDS_STANDARD_TIME "Hora Padrão das Ilhas Chatham"
UTC +13:00 TONGA__STANDARD_TIME "Hora Padrão de Tonga"
UTC +13:00 SAMOA_STANDARD_TIME "Hora Padrão de Samoa"
UTC +14:00 LINE_ISLANDS_STANDARD_TIME "Hora Padrão das Ilhas da Linha"