Partager via


Schéma YAML pour le programmes d’importation CLI (v2)

S’APPLIQUE À :Extension ml Azure CLI v2 (actuelle)

Le schéma JSON source se trouve à l’adresse https://azuremlschemas.azureedge.net/latest/schedule.schema.json.

Notes

La syntaxe YAML détaillée dans ce document est basée sur le schéma JSON pour la dernière version de l’extension ML CLI v2. Le fonctionnement de cette syntaxe est garanti uniquement avec la dernière version de l’extension ML CLI v2. Vous trouverez les schémas des versions d’extension plus anciennes sur https://azuremlschemasprod.azureedge.net/.

Syntaxe YAML

Clé Catégorie Descriptif Valeurs autorisées
$schema ficelle Schéma YAML.
name ficelle Obligatoire. Nom de la planification.
description ficelle Description de la planification.
tags objet Dictionnaire d’étiquettes de la planification.
trigger objet Configuration du déclencheur pour définir la règle précisant quand déclencher un travail. RecurrenceTrigger ou CronTrigger est obligatoire.
import_data Objet ou chaîne Obligatoire. Définition de l’action d’importation de données déclenchée par une planification. string ou ImportDataDefinition est obligatoire.

Configuration de déclencheur

Déclencheur recurrence

Clé Catégorie Descriptif Valeurs autorisées
type ficelle Obligatoire. Spécifie le type de planification. récurrence
frequency ficelle Obligatoire. Spécifie l’unité de temps qui décrit la fréquence à laquelle la planification se déclenche. minute, , hourday, , weekmonth
interval entier Obligatoire. Spécifie l’intervalle de déclenchement de la planification.
start_time ficelle Décrit la date et l’heure de début avec le fuseau horaire. Si start_time est omis, le premier travail s’exécute instantanément et les travaux ultérieurs sont déclenchés en fonction de la planification, autrement dit start_time correspondra à l’heure de création du travail. Si l’heure de début se situe dans le passé, la première tâche est exécutée à l’heure d’exécution calculée suivante.
end_time ficelle Décrit la date et l’heure de fin avec le fuseau horaire. Si end_time est omis, la planification s’exécute jusqu’à ce qu’elle soit explicitement désactivée.
timezone ficelle Spécifie le fuseau horaire de la périodicité. S’il est omis, la valeur par défaut est UTC. Consultez l’annexe pour connaître les valeurs de fuseau horaire.
pattern objet Spécifie le modèle de la périodicité. Si le modèle est omis, le ou les travaux sont déclenchés en fonction de la logique de start_time, de la fréquence et de l’intervalle.

Planification de périodicité

La planification de périodicité définit le modèle de périodicité, contenant hours, minutes et weekdays.

  • Quand la fréquence est day, le modèle peut spécifier hours et minutes.
  • Quand la fréquence est week et month, le modèle peut spécifier hours, minutes et weekdays.
Clé Catégorie Valeurs autorisées
hours entier ou tableau d’entiers 0-23
minutes entier ou tableau d’entiers 0-59
week_days chaîne ou tableau de chaînes monday, tuesday, , wednesdaythursday, friday, , saturday,sunday

CronTrigger

Clé Catégorie Descriptif Valeurs autorisées
type ficelle Obligatoire. Spécifie le type de planification. cron
expression ficelle Obligatoire. Spécifie l’expression cron pour définir comment déclencher les travaux. L’expression utilise l’expression crontab standard pour exprimer une planification périodique. Une expression unique est composée de cinq champs délimités par l’espace :MINUTES HOURS DAYS MONTHS DAYS-OF-WEEK
start_time ficelle Décrit la date et l’heure de début avec le fuseau horaire. Si start_time est omis, le premier travail s’exécute instantanément et les travaux ultérieurs sont déclenchés en fonction de la planification, autrement dit start_time correspondra à l’heure de création du travail. Si l’heure de début se situe dans le passé, la première tâche est exécutée à l’heure d’exécution calculée suivante.
end_time ficelle Décrit la date et l’heure de fin avec le fuseau horaire. Si end_time est omis, la planification continue à s’exécuter jusqu’à ce qu’elle soit explicitement désactivée.
timezone ficelle Spécifie le fuseau horaire de la périodicité. S’il est omis, la valeur par défaut est UTC. Consultez l’annexe pour connaître les valeurs de fuseau horaire.

Importer la définition des données (préversion)

Important

Cette fonctionnalité est actuellement disponible en préversion publique. Cette préversion est fournie sans contrat de niveau de service et n’est pas recommandée pour les charges de travail de production. Certaines fonctionnalités peuvent être limitées ou non prises en charge.

Pour plus d’informations, consultez Conditions d’Utilisation Supplémentaires relatives aux Évaluations Microsoft Azure.

Le client peut utiliser import_data: ./<data_import>.yaml directement ou utiliser les propriétés suivantes pour définir le travail d’importation des données.

Clé Catégorie Descriptif Valeurs autorisées
type ficelle Obligatoire. Spécifie le type de ressource de données sous lequel vous souhaitez importer les données. Il peut s’agir de mlable lors de l’importation à partir d’une source de base de données ou d’uri_folder lors de l’importation à partir d’un FileSource. mltable, uri_folder
name ficelle Obligatoire. Nom de la ressource de données sous laquelle inscrire les données importées.
path ficelle Obligatoire. Chemin d’accès au magasin de données qui prend les données importées, spécifié de l’une des deux manières suivantes :

- Obligatoire. URI du chemin d’accès au magasin de données. Le seul type d’URI pris en charge est azureml. Pour plus d’informations sur l’utilisation du format d’URI azureml://, consultez Syntaxe YAML fondamentale. Pour éviter un remplacement, un chemin d’accès unique pour chaque importation est recommandé. Pour cela, paramétrisez le chemin d’accès comme illustré dans cet exemple - azureml://datastores/<datastore_name>/paths/<source_name>/${{name}}. Le paramètre « datastore_name » dans l’exemple peut être un magasin de données que vous avez créé ou le magasin de données workspaceblobstore. Vous pouvez aussi sélectionner un « magasin de données managées » par référencement comme illustré : azureml://datastores/workspacemanagedstore, où le système affecte automatiquement un chemin d’accès unique.
Azure Machine Learning ://<>
source objet Détails de la source externe de la source des données importée. Consultez les Attributs de source pour le jeu de propriétés source.

Attributs de source (préversion)

Clé Catégorie Descriptif Valeurs autorisées Valeur par défaut
type ficelle Type de la source externe à partir de laquelle vous envisagez d’importer des données. Seuls les types suivants sont autorisés pour le moment - Database ou FileSystem Database, FileSystem
query ficelle Définissez cette valeur uniquement lorsque type défini ci-dessus est database La requête dans la source externe de type Database qui définit ou filtre les données à importer.
path ficelle Définissez cette valeur uniquement lorsque le type défini ci-dessus est FileSystem Le chemin d’accès au dossier situé dans la source externe de type FileSystem, où résident le(s) fichier(s) ou les données à importer.
connection ficelle Obligatoire. Propriété de connexion pour la source externe référencée au format azureml:<connection_name>

Important

Cette fonctionnalité est actuellement disponible en préversion publique. Cette préversion est fournie sans contrat de niveau de service et n’est pas recommandée pour les charges de travail de production. Certaines fonctionnalités peuvent être limitées ou non prises en charge.

Pour plus d’informations, consultez Conditions d’Utilisation Supplémentaires relatives aux Évaluations Microsoft Azure.

Remarques

La commande az ml schedule peut être utilisée pour gérer les modèles Azure Machine Learning.

Exemples

Des exemples sont disponibles dans le référentiel d’exemples GitHub. Vous en trouverez quelques-uns ci-dessous.

YAML : planifier l’importation de données avec un modèle de périodicité

S’APPLIQUE À :Extension ml Azure CLI v2 (actuelle)

YAML : Planifier l’importation de données avec un modèle de périodicité (préversion)

$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 : Planifier la définition d’importation de données inline avec un modèle de périodicité sur le magasin de données managé (préversion)

$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 : planifier l’importation de données avec une expression

S’APPLIQUE À :Extension ml Azure CLI v2 (actuelle)

YAML : Planifier l’importation de données avec une expression cron (préversion)

$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 : Planifier la définition d’importation de données inline avec une expression cron (préversion)

$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

Annexe

Fuseau horaire

La planification actuelle prend en charge les fuseaux horaires de cette table. La clé peut être utilisée directement dans le SDK Python, tandis que la valeur peut être utilisée dans l’importation de données YAML. Le tableau est organisé par UTC (Temps universel coordonné).

UTC Clé Valeur
UTC -12:00 DATELINE_STANDARD_TIME « Dateline Standard Time »
UTC -11:00 UTC_11 « UTC-11 »
UTC - 10:00 ALEUTIAN_STANDARD_TIME Heure standard des îles Aléoutiennes
UTC - 10:00 HAWAIIAN_STANDARD_TIME « Heure standard hawaïenne »
UTC -09:30 MARQUESAS_STANDARD_TIME « Marqueas Standard Time »
UTC -09:00 ALASKAN_STANDARD_TIME « Alaskan Standard Time »
UTC -09:00 UTC_09 « UTC-09 »
UTC -08:00 PACIFIC_STANDARD_TIME_MEXICO « Pacific Standard Time (Mexique) »
UTC -08:00 UTC_08 « UTC-08 »
UTC -08:00 PACIFIC_STANDARD_TIME « Pacific Standard Time »
UTC -07:00 US_MOUNTAIN_STANDARD_TIME « US Mountain Standard Time »
UTC -07:00 MOUNTAIN_STANDARD_TIME_MEXICO « Mountain Standard Time (Mexique) »
UTC -07:00 MOUNTAIN_STANDARD_TIME « Mountain Standard Time »
UTC -06:00 CENTRAL_AMERICA_STANDARD_TIME « Heure standard de l’Amérique centrale »
UTC -06:00 CENTRAL_STANDARD_TIME « Temps standard central »
UTC -06:00 EASTER_ISLAND_STANDARD_TIME « Temps standard de l’île de Pâques »
UTC -06:00 CENTRAL_STANDARD_TIME_MEXICO « Heure standard centrale (Mexique) »
UTC -06:00 CANADA_CENTRAL_STANDARD_TIME « Heure standard centrale du Canada »
UTC -05:00 SA_PACIFIC_STANDARD_TIME « SA Pacific Standard Time »
UTC -05:00 EASTERN_STANDARD_TIME_MEXICO « Heure standard de l’Est (Mexique) »
UTC -05:00 EASTERN_STANDARD_TIME « Heure standard de l’Est »
UTC -05:00 HAITI_STANDARD_TIME « Haïti Standard Time »
UTC -05:00 CUBA_STANDARD_TIME « Cuba Standard Time »
UTC -05:00 US_EASTERN_STANDARD_TIME « Usa Est Standard Time »
UTC -05:00 TURKS_AND_CAICOS_STANDARD_TIME « Turks And Caicos Standard Time »
UTC -04:00 PARAGUAY_STANDARD_TIME « Heure standard du Paraguay »
UTC -04:00 ATLANTIC_STANDARD_TIME « Heure standard de l’Atlantique »
UTC -04:00 VENEZUELA_STANDARD_TIME « Venezuela Standard Time »
UTC -04:00 CENTRAL_BRAZILIAN_STANDARD_TIME « Temps standard du Brésil central »
UTC -04:00 SA_WESTERN_STANDARD_TIME « SA Western Standard Time »
UTC -04:00 PACIFIC_SA_STANDARD_TIME « Pacific SA Standard Time »
UTC -03:30 NEWFOUNDLAND_STANDARD_TIME « Heure standard de Terre-Neuve »
UTC -03:00 TOCANTINS_STANDARD_TIME « Temps standard de Tocantins »
UTC -03:00 E_SOUTH_AMERICAN_STANDARD_TIME "E. Heure standard de l’Amérique du Sud »
UTC -03:00 SA_EASTERN_STANDARD_TIME « SA Eastern Standard Time »
UTC -03:00 ARGENTINA_STANDARD_TIME « Argentine Standard Time »
UTC -03:00 GREENLAND_STANDARD_TIME « Heure standard du Groenland »
UTC -03:00 MONTEVIDEO_STANDARD_TIME « Montevideo Standard Time »
UTC -03:00 SAINT_PIERRE_STANDARD_TIME « Saint Pierre Standard Time »
UTC -03:00 BAHIA_STANDARD_TIM « Heure standard de Bahía »
UTC -02:00 UTC_02 « UTC-02 »
UTC -02:00 MID_ATLANTIC_STANDARD_TIME «Mid-Atlantic Heure standard »
UTC -01:00 AZORES_STANDARD_TIME « Azores Standard Time »
UTC -01:00 CAPE_VERDE_STANDARD_TIME « Cap-Vert Standard Time »
UTC UTC UTC
UTC +00:00 GMT_STANDARD_TIME « Heure standard GMT »
UTC +00:00 GREENWICH_STANDARD_TIME « Heure standard de Greenwich »
UTC +01:00 MOROCCO_STANDARD_TIME « Maroc Standard Time »
UTC +01:00 W_EUROPE_STANDARD_TIME "W. Europe Standard Time"
UTC +01:00 CENTRAL_EUROPE_STANDARD_TIME « Heure standard de l’Europe centrale »
UTC +01:00 ROMANCE_STANDARD_TIME « Romance Standard Time »
UTC +01:00 CENTRAL_EUROPEAN_STANDARD_TIME « Heure standard de l’Europe centrale »
UTC +01:00 W_CENTRAL_AFRICA_STANDARD_TIME "W. Heure standard de l’Afrique centrale »
UTC +02:00 NAMIBIA_STANDARD_TIME « Namibie Standard Time »
UTC +02:00 JORDAN_STANDARD_TIME « Jordan Standard Time »
UTC +02:00 GTB_STANDARD_TIME « Temps standard GTB »
UTC +02:00 MIDDLE_EAST_STANDARD_TIME « Temps standard du Moyen-Orient »
UTC +02:00 EGYPT_STANDARD_TIME « Egypt Standard Time »
UTC +02:00 E_EUROPE_STANDARD_TIME "E. Europe Standard Time"
UTC +02:00 SYRIA_STANDARD_TIME « Temps standard de la Syrie »
UTC +02:00 WEST_BANK_STANDARD_TIME « Heure standard de la Cisjordanie »
UTC +02:00 SOUTH_AFRICA_STANDARD_TIME « Heure standard de l’Afrique du Sud »
UTC +02:00 FLE_STANDARD_TIME « Temps standard FLE »
UTC +02:00 ISRAEL_STANDARD_TIME « Israël Standard Time »
UTC +02:00 KALININGRAD_STANDARD_TIME « Kaliningrad Standard Time »
UTC +02:00 LIBYA_STANDARD_TIME « Temps standard de la Libye »
UTC +03:00 TÜRKIYE_STANDARD_TIME « Heure standard de la Turquie »
UTC +03:00 ARABIC_STANDARD_TIME « Heure standard arabe »
UTC +03:00 ARAB_STANDARD_TIME « Heure standard arabe »
UTC +03:00 BELARUS_STANDARD_TIME « Heure standard du Belarus »
UTC +03:00 RUSSIAN_STANDARD_TIME « Temps standard russe »
UTC +03:00 E_AFRICA_STANDARD_TIME "E. Afrique Standard Time"
UTC +03:30 IRAN_STANDARD_TIME « Iran Standard Time »
UTC +04:00 ARABIAN_STANDARD_TIME « Temps standard arabe »
UTC +04:00 ASTRAKHAN_STANDARD_TIME « Astrakhan Standard Time »
UTC +04:00 AZERBAIJAN_STANDARD_TIME « Azerbaïdjan Standard Time »
UTC +04:00 RUSSIA_TIME_ZONE_3 « Fuseau horaire de Russie 3 »
UTC +04:00 MAURITIUS_STANDARD_TIME « Maurice Standard Time »
UTC +04:00 GEORGIAN_STANDARD_TIME « Heure standard géorgienne »
UTC +04:00 CAUCASUS_STANDARD_TIME « Heure standard du Caucase »
UTC +04:30 AFGHANISTAN_STANDARD_TIME « Afghanistan Standard Time »
UTC +05:00 WEST_ASIA_STANDARD_TIME « Heure standard de l’Asie Ouest »
UTC +05:00 EKATERINBURG_STANDARD_TIME « Ekaterinburg Standard Time »
UTC +05:00 PAKISTAN_STANDARD_TIME « Pakistan Standard Time »
UTC +05:30 INDIA_STANDARD_TIME « Inde Standard Time »
UTC +05:30 SRI_LANKA_STANDARD_TIME « Sri Lanka Standard Time »
UTC +05:45 NEPAL_STANDARD_TIME « Népal Standard Time »
UTC +06:00 CENTRAL_ASIA_STANDARD_TIME « Heure standard de l’Asie centrale »
UTC +06:00 BANGLADESH_STANDARD_TIME « Bangladesh Standard Time »
UTC +06:30 MYANMAR_STANDARD_TIME « Myanmar Standard Time »
UTC +07:00 N_CENTRAL_ASIA_STANDARD_TIME "N. Heure standard de l’Asie centrale »
UTC +07:00 SE_ASIA_STANDARD_TIME « SE Asia Standard Time »
UTC +07:00 ALTAI_STANDARD_TIME « Altai Standard Time »
UTC +07:00 W_MONGOLIA_STANDARD_TIME "W. Heure standard mongole"
UTC +07:00 NORTH_ASIA_STANDARD_TIME « Heure standard de l’Asie du Nord »
UTC +07:00 TOMSK_STANDARD_TIME « Tomsk Standard Time »
UTC +08:00 CHINA_STANDARD_TIME « Chine Standard Time »
UTC +08:00 NORTH_ASIA_EAST_STANDARD_TIME « Heure standard de l’Asie du Nord Est »
UTC +08:00 SINGAPORE_STANDARD_TIME « Singapour Standard Time »
UTC +08:00 W_AUSTRALIA_STANDARD_TIME "W. Australie Standard Time"
UTC +08:00 TAIPEI_STANDARD_TIME « Taipei Standard Time »
UTC +08:00 ULAANBAATAR_STANDARD_TIME « Temps standard Ulaanbaatar »
UTC +08:45 AUS_CENTRAL_W_STANDARD_TIME « Aus Central W. Standard Time »
UTC +09:00 NORTH_KOREA_STANDARD_TIME « Heure standard de la Corée du Nord »
UTC +09:00 TRANSBAIKAL_STANDARD_TIME « Transbaikal Standard Time »
UTC +09:00 TOKYO_STANDARD_TIME « Tokyo Standard Time »
UTC +09:00 KOREA_STANDARD_TIME « Corée Standard Time »
UTC +09:00 YAKUTSK_STANDARD_TIME « Temps standard Yakutsk »
UTC +09:30 CEN_AUSTRALIA_STANDARD_TIME "Cen. Australie Standard Time"
UTC +09:30 AUS_CENTRAL_STANDARD_TIME « AuS Central Standard Time »
UTC +10:00 E_AUSTRALIAN_STANDARD_TIME "E. Australie Standard Time"
UTC +10:00 AUS_EASTERN_STANDARD_TIME « AUS Eastern Standard Time »
UTC +10:00 WEST_PACIFIC_STANDARD_TIME « Heure standard du Pacifique Ouest »
UTC +10:00 TASMANIA_STANDARD_TIME « Tasmania Standard Time »
UTC +10:00 VLADIVOSTOK_STANDARD_TIME « Temps standard Vladivostok »
UTC +10:30 LORD_HOWE_STANDARD_TIME « Lord Howe Standard Time »
UTC +11:00 BOUGAINVILLE_STANDARD_TIME « Bougainville Standard Time »
UTC +11:00 RUSSIA_TIME_ZONE_10 « Zone de temps russie 10 »
UTC +11:00 MAGADAN_STANDARD_TIME « Magadan Standard Time »
UTC +11:00 NORFOLK_STANDARD_TIME « Norfolk Standard Time »
UTC +11:00 SAKHALIN_STANDARD_TIME « Sakhalin Standard Time »
UTC +11:00 CENTRAL_PACIFIC_STANDARD_TIME « Heure standard du Pacifique central »
UTC +12:00 RUSSIA_TIME_ZONE_11 « Zone de temps russie 11 »
UTC +12:00 NEW_ZEALAND_STANDARD_TIME « Heure standard de la Nouvelle-Zélande »
UTC +12:00 UTC_12 « UTC+12 »
UTC +12:00 FIJI_STANDARD_TIME « Fidji Standard Time »
UTC +12:00 KAMCHATKA_STANDARD_TIME « Kamchatka Standard Time »
UTC +12:45 CHATHAM_ISLANDS_STANDARD_TIME « Chatham Islands Standard Time »
UTC +13:00 TONGA__STANDARD_TIME « Temps standard tonga »
UTC +13:00 SAMOA_STANDARD_TIME « Heure standard des Samoa »
UTC +14:00 LINE_ISLANDS_STANDARD_TIME « Line Islands Standard Time »