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

Artigo
05/28/2023

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

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

Observação

A sintaxe YAML detalhada neste documento baseia-se no esquema JSON da última versão da extensão de ML da CLI v2. Essa sintaxe só tem a garantia de funcionar com a última versão da extensão de ML da CLI v2. Encontre os esquemas para as versões mais antigas da extensão em https://azuremlschemasprod.azureedge.net/.

Sintaxe YAML

Chave	Type	Descrição
`$schema`	string	O esquema YAML.
`name`	string	Obrigatórios. Nome da agenda.
`description`	string	Descrição do agendamento.
`tags`	objeto	Dicionário de marcas para o agendamento.
`trigger`	objeto	A configuração do gatilho para definir a regra de quando disparar o trabalho. Um dos dois é obrigatório, `RecurrenceTrigger` ou `CronTrigger`.
`import_data`	objeto ou cadeia de caracteres	Obrigatórios. A definição da ação de importação de dados disparada por um agendamento. Um dos dois é obrigatório, `string` ou `ImportDataDefinition`.

Configuração de gatilho

Gatilho de recorrência

Chave	Type	Descrição	Valores permitidos
`type`	string	Obrigatórios. Especifica o tipo de agendamento.	recurrence
`frequency`	string	Obrigatórios. Especifica a unidade de tempo que descreve a frequência com que o agendamento é acionado.	`minute`, `hour`, `day`, `week`, `month`
`interval`	Número inteiro	Obrigatórios. Especifica o intervalo no qual o agendamento é acionado.
`start_time`	string	Descreve a data e a hora de início com fuso horário. Se start_time for omitido, o primeiro trabalho será executado instantaneamente, e os trabalhos futuros disparados com base no agendamento, dizendo que start_time corresponderá à hora de criação do trabalho. 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 a hora de término com fuso horário. Se end_time for omitido, o agendamento é executado até que seja explicitamente desabilitado.
`timezone`	string	Especifica o fuso horário da recorrência. Se omitido, por padrão será UTC.	Consulte o apêndice para obter valores de fuso horário
`pattern`	objeto	Especifica o padrão da recorrência. Se o padrão for omitido, o(s) trabalho(s) será(ão) disparado(s) de acordo com a lógica de start_time, frequência e intervalo.

Agendamento de recorrência

O agendamento de recorrência define o padrão de recorrência, contendo hours, minutes e 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.

Chave	Type	Valores permitidos
`hours`	inteiro ou matriz de inteiro	`0-23`
`minutes`	inteiro ou matriz de inteiro	`0-59`
`week_days`	cadeia de caracteres ou matriz de cadeias de caracteres	`monday`, `tuesday`, `wednesday`, `thursday`, `friday`, `saturday`, `sunday`

CronTrigger

Chave	Type	Descrição	Valores permitidos
`type`	string	Obrigatórios. Especifica o tipo de agendamento.	cron
`expression`	string	Obrigatórios. Especifica a expressão cron para definir como disparar trabalhos. expressão usa a expressão crontab padrão para expressar um agendamento 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 a 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 disparados com base no agendamento, dizendo que start_time corresponderá à hora de criação do trabalho. 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 a hora de término com fuso horário. Se end_time for omitido, o agendamento continua a ser executado até que seja explicitamente desabilitado.
`timezone`	string	Especifica o fuso horário da recorrência. Se omitido, por padrão será UTC.	Consulte o apêndice para obter valores de fuso horário

Importar a definição de dados (pré-visualização)

Importante

Esse recurso está atualmente em visualização pública. Essa versão prévia é fornecida sem um contrato de nível de serviço e não é recomendada para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos.

Para obter mais informações, consulte Termos de Uso Complementares de Versões Prévias 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	Type	Descrição	Valores permitidos
`type`	string	Obrigatórios. Especifica o tipo de ativo de dados para o qual você deseja importar os dados. 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órios. 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. O único tipo de URI com suporte é `azureml`. Para saber mais sobre como usar o formato URI `azureml://`, confira Sintaxe principal do YAML. Para evitar uma gravação excessiva, recomenda-se um caminho exclusivo para cada importação. Para fazer isto, parametrize o caminho conforme mostrado neste exemplo - `azureml://datastores/<datastore_name>/paths/<source_name>/${{name}}`. O parâmetro "datastore_name" no exemplo pode ser um armazenamento de dados que você criou ou o workspaceblobstore. Como alternativa, um "armazenamento de dados gerenciado" pode ser selecionado por meio de referência conforme mostrado: `azureml://datastores/workspacemanagedstore`, em que o sistema atribui automaticamente um caminho exclusivo.	Azure Machine Learning://<>
`source`	objeto	Detalhes da fonte externa para fontes de dados importados. Consulte Atributos da `source` para o conjunto de propriedades de origem.

Atributos de `source` (pré-visualização)

Chave	Type	Descrição	Valores permitidos
`type`	string	O tipo de fonte externa da qual você pretende importar os dados. Só são permitidos os seguintes tipos 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 os dados que devem ser importados.
`path`	string	Defina isso somente quando o `type` definido acima for `FileSystem` O caminho da pasta na fonte externa do tipo `FileSystem` onde residem os arquivos ou dados que precisam ser importados.
`connection`	string	Obrigatórios. A propriedade de conexão para a fonte externa de referência no formato de `azureml:<connection_name>`

Importante

Para obter mais informações, consulte Termos de Uso Complementares de Versões Prévias do Microsoft Azure.

Comentários

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

Exemplos

Os exemplos estão disponíveis no repositório de exemplos do GitHub. Alguns são mostrados abaixo.

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

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

YAML: Agendamento para importação de dados com padrão de recorrência (pré-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 gerenciados (pré-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: agendamento para importação de dados com a expressão cron