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é | Type | Description | Valeurs autorisées |
---|---|---|---|
$schema |
string | Schéma YAML. | |
name |
string | Obligatoire. Nom de la planification. | |
description |
string | Description de la planification. | |
tags |
object | Dictionnaire d’étiquettes de la planification. | |
trigger |
object | 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é | Type | Description | Valeurs autorisées |
---|---|---|---|
type |
string | Obligatoire. Spécifie le type de planification. | recurrence |
frequency |
string | Obligatoire. Spécifie l’unité de temps qui décrit la fréquence à laquelle la planification se déclenche. | minute , , hour day , , week month |
interval |
entier | Obligatoire. Spécifie l’intervalle de déclenchement de la planification. | |
start_time |
string | 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 |
string | 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 |
string | 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 |
object | 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écifierhours
etminutes
. - Quand la fréquence est
week
etmonth
, le modèle peut spécifierhours
,minutes
etweekdays
.
Clé | Type | 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 , , thursday wednesday , friday , , saturday ,sunday |
CronTrigger
Clé | Type | Description | Valeurs autorisées |
---|---|---|---|
type |
string | Obligatoire. Spécifie le type de planification. | cron |
expression |
string | 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 |
string | 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 |
string | 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 |
string | 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é | Type | Description | Valeurs autorisées |
---|---|---|---|
type |
string | 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 |
string | Obligatoire. Nom de la ressource de données sous laquelle inscrire les données importées. | |
path |
string | 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 |
object | 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é | Type | Description | Valeurs autorisées | Valeur par défaut |
---|---|---|---|---|
type |
string | 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 |
string | 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 |
string | 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 |
string | 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 Azure CLI ml 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 | "Hawaiian Standard Time" |
UTC -09:30 | MARQUESAS_STANDARD_TIME | "Marquesas 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 (Mexico)" |
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 (Mexico)" |
UTC -07:00 | MOUNTAIN_STANDARD_TIME | "Mountain Standard Time" |
UTC -06:00 | CENTRAL_AMERICA_STANDARD_TIME | "Central America Standard Time" |
UTC -06:00 | CENTRAL_STANDARD_TIME | "Central Standard Time" |
UTC -06:00 | EASTER_ISLAND_STANDARD_TIME | "Easter Island Standard Time" |
UTC -06:00 | CENTRAL_STANDARD_TIME_MEXICO | "Central Standard Time (Mexico)" |
UTC -06:00 | CANADA_CENTRAL_STANDARD_TIME | "Canada Central Standard Time" |
UTC -05:00 | SA_PACIFIC_STANDARD_TIME | "SA Pacific Standard Time" |
UTC -05:00 | EASTERN_STANDARD_TIME_MEXICO | "Eastern Standard Time (Mexico)" |
UTC -05:00 | EASTERN_STANDARD_TIME | "Eastern Standard Time" |
UTC -05:00 | HAITI_STANDARD_TIME | "Haiti Standard Time" |
UTC -05:00 | CUBA_STANDARD_TIME | "Cuba Standard Time" |
UTC -05:00 | US_EASTERN_STANDARD_TIME | "US Eastern Standard Time" |
UTC -05:00 | TURKS_AND_CAICOS_STANDARD_TIME | "Turks And Caicos Standard Time" |
UTC -04:00 | PARAGUAY_STANDARD_TIME | "Paraguay Standard Time" |
UTC -04:00 | ATLANTIC_STANDARD_TIME | "Atlantic Standard Time" |
UTC -04:00 | VENEZUELA_STANDARD_TIME | "Venezuela Standard Time" |
UTC -04:00 | CENTRAL_BRAZILIAN_STANDARD_TIME | "Central Brazilian Standard Time" |
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 | "Newfoundland Standard Time" |
UTC -03:00 | TOCANTINS_STANDARD_TIME | "Tocantins Standard Time" |
UTC -03:00 | E_SOUTH_AMERICAN_STANDARD_TIME | "E. South America Standard Time" |
UTC -03:00 | SA_EASTERN_STANDARD_TIME | "SA Eastern Standard Time" |
UTC -03:00 | ARGENTINA_STANDARD_TIME | "Argentina Standard Time" |
UTC -03:00 | GREENLAND_STANDARD_TIME | "Greenland Standard Time" |
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 | "Bahia Standard Time" |
UTC -02:00 | UTC_02 | "UTC-02" |
UTC -02:00 | MID_ATLANTIC_STANDARD_TIME | "Mid-Atlantic Standard Time" |
UTC -01:00 | AZORES_STANDARD_TIME | "Azores Standard Time" |
UTC -01:00 | CAPE_VERDE_STANDARD_TIME | "Cape Verde Standard Time" |
UTC | UTC | UTC |
UTC +00:00 | GMT_STANDARD_TIME | "GMT Standard Time" |
UTC +00:00 | GREENWICH_STANDARD_TIME | "Greenwich Standard Time" |
UTC +01:00 | MOROCCO_STANDARD_TIME | "Morocco Standard Time" |
UTC +01:00 | W_EUROPE_STANDARD_TIME | "W. Europe Standard Time" |
UTC +01:00 | CENTRAL_EUROPE_STANDARD_TIME | "Central Europe Standard Time" |
UTC +01:00 | ROMANCE_STANDARD_TIME | "Romance Standard Time" |
UTC +01:00 | CENTRAL_EUROPEAN_STANDARD_TIME | "Central European Standard Time" |
UTC +01:00 | W_CENTRAL_AFRICA_STANDARD_TIME | "W. Central Africa Standard Time" |
UTC +02:00 | NAMIBIA_STANDARD_TIME | "Namibia Standard Time" |
UTC +02:00 | JORDAN_STANDARD_TIME | "Jordan Standard Time" |
UTC +02:00 | GTB_STANDARD_TIME | "GTB Standard Time" |
UTC +02:00 | MIDDLE_EAST_STANDARD_TIME | "Middle East Standard Time" |
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 | "Syria Standard Time" |
UTC +02:00 | WEST_BANK_STANDARD_TIME | "West Bank Standard Time" |
UTC +02:00 | SOUTH_AFRICA_STANDARD_TIME | "South Africa Standard Time" |
UTC +02:00 | FLE_STANDARD_TIME | "FLE Standard Time" |
UTC +02:00 | ISRAEL_STANDARD_TIME | "Israel Standard Time" |
UTC +02:00 | KALININGRAD_STANDARD_TIME | "Kaliningrad Standard Time" |
UTC +02:00 | LIBYA_STANDARD_TIME | "Libya Standard Time" |
UTC +03:00 | TÜRKIYE_STANDARD_TIME | « Heure standard de la Turquie » |
UTC +03:00 | ARABIC_STANDARD_TIME | "Arabic Standard Time" |
UTC +03:00 | ARAB_STANDARD_TIME | "Arab Standard Time" |
UTC +03:00 | BELARUS_STANDARD_TIME | "Belarus Standard Time" |
UTC +03:00 | RUSSIAN_STANDARD_TIME | "Russian Standard Time" |
UTC +03:00 | E_AFRICA_STANDARD_TIME | "E. Africa Standard Time" |
UTC +03:30 | IRAN_STANDARD_TIME | "Iran Standard Time" |
UTC +04:00 | ARABIAN_STANDARD_TIME | "Arabian Standard Time" |
UTC +04:00 | ASTRAKHAN_STANDARD_TIME | "Astrakhan Standard Time" |
UTC +04:00 | AZERBAIJAN_STANDARD_TIME | "Azerbaijan Standard Time" |
UTC +04:00 | RUSSIA_TIME_ZONE_3 | "Russia Time Zone 3" |
UTC +04:00 | MAURITIUS_STANDARD_TIME | "Mauritius Standard Time" |
UTC +04:00 | GEORGIAN_STANDARD_TIME | "Georgian Standard Time" |
UTC +04:00 | CAUCASUS_STANDARD_TIME | "Caucasus Standard Time" |
UTC +04:30 | AFGHANISTAN_STANDARD_TIME | "Afghanistan Standard Time" |
UTC +05:00 | WEST_ASIA_STANDARD_TIME | "West Asia Standard Time" |
UTC +05:00 | EKATERINBURG_STANDARD_TIME | "Ekaterinburg Standard Time" |
UTC +05:00 | PAKISTAN_STANDARD_TIME | "Pakistan Standard Time" |
UTC +05:30 | INDIA_STANDARD_TIME | "India Standard Time" |
UTC +05:30 | SRI_LANKA_STANDARD_TIME | "Sri Lanka Standard Time" |
UTC +05:45 | NEPAL_STANDARD_TIME | "Nepal Standard Time" |
UTC +06:00 | CENTRAL_ASIA_STANDARD_TIME | "Central Asia Standard Time" |
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. Central Asia Standard Time" |
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. Mongolia Standard Time" |
UTC +07:00 | NORTH_ASIA_STANDARD_TIME | "North Asia Standard Time" |
UTC +07:00 | TOMSK_STANDARD_TIME | "Tomsk Standard Time" |
UTC +08:00 | CHINA_STANDARD_TIME | "China Standard Time" |
UTC +08:00 | NORTH_ASIA_EAST_STANDARD_TIME | "North Asia East Standard Time" |
UTC +08:00 | SINGAPORE_STANDARD_TIME | "Singapore Standard Time" |
UTC +08:00 | W_AUSTRALIA_STANDARD_TIME | "W. Australia Standard Time" |
UTC +08:00 | TAIPEI_STANDARD_TIME | "Taipei Standard Time" |
UTC +08:00 | ULAANBAATAR_STANDARD_TIME | "Ulaanbaatar Standard Time" |
UTC +08:45 | AUS_CENTRAL_W_STANDARD_TIME | "Aus Central W. Standard Time" |
UTC +09:00 | NORTH_KOREA_STANDARD_TIME | "North Korea Standard Time" |
UTC +09:00 | TRANSBAIKAL_STANDARD_TIME | "Transbaikal Standard Time" |
UTC +09:00 | TOKYO_STANDARD_TIME | "Tokyo Standard Time" |
UTC +09:00 | KOREA_STANDARD_TIME | "Korea Standard Time" |
UTC +09:00 | YAKUTSK_STANDARD_TIME | "Yakutsk Standard Time" |
UTC +09:30 | CEN_AUSTRALIA_STANDARD_TIME | "Cen. Australia Standard Time" |
UTC +09:30 | AUS_CENTRAL_STANDARD_TIME | "AUS Central Standard Time" |
UTC +10:00 | E_AUSTRALIAN_STANDARD_TIME | "E. Australia Standard Time" |
UTC +10:00 | AUS_EASTERN_STANDARD_TIME | "AUS Eastern Standard Time" |
UTC +10:00 | WEST_PACIFIC_STANDARD_TIME | "West Pacific Standard Time" |
UTC +10:00 | TASMANIA_STANDARD_TIME | "Tasmania Standard Time" |
UTC +10:00 | VLADIVOSTOK_STANDARD_TIME | "Vladivostok Standard Time" |
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 | "Russia Time Zone 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 | "Central Pacific Standard Time" |
UTC +12:00 | RUSSIA_TIME_ZONE_11 | "Russia Time Zone 11" |
UTC +12:00 | NEW_ZEALAND_STANDARD_TIME | "New Zealand Standard Time" |
UTC +12:00 | UTC_12 | "UTC+12" |
UTC +12:00 | FIJI_STANDARD_TIME | "Fiji 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 | "Tonga Standard Time" |
UTC +13:00 | SAMOA_STANDARD_TIME | "Samoa Standard Time" |
UTC +14:00 | LINE_ISLANDS_STANDARD_TIME | "Line Islands Standard Time" |