Esquema YAML de agendamento de importação CLI (v2)
APLICA-SE A: Azure CLI ml extension 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
Chave | 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
Chave | 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 , hour , day , week , month |
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
, minutes
e weekdays
.
- Quando a frequência é
day
, o padrão pode especificarhours
eminutes
. - Quando a frequência é
week
emonth
, o padrão pode especificarhours
,minutes
eweekdays
.
Chave | Type | 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 , tuesday , wednesday , thursday , friday , saturday , sunday |
CronTrigger
Chave | 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 import_data: ./<data_import>.yaml
diretamente ou pode usar as seguintes propriedades para definir a definição de importação de dados.
Chave | 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)
Chave | 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 type definido acima for FileSystem O caminho da pasta na fonte externa do tipo FileSystem onde residem o(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: Azure CLI ml extension 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: Azure CLI ml extension 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" |