Partager via

az ml feature-store

Note

Cette référence fait partie de l’extension ml pour Azure CLI (version 2.15.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une az ml feature-store commande. Apprenez-en davantage sur les extensions.

Gérer les magasins de fonctionnalités Azure ML.

Un magasin de fonctionnalités est un système de gestion du cycle de vie pour les fonctionnalités. Le magasin de fonctionnalités fournit la découverte des fonctionnalités, la matérialisation servant des charges de travail hors connexion (inférence de formation/traitement par lots), la mise en service de l’inférence en ligne avec des exigences de faible latence, ainsi que la surveillance de la qualité des fonctionnalités et opérationnelles.

Commandes

Nom Description Type État
az ml feature-store create

Créez un magasin de fonctionnalités.

 Extension GA
az ml feature-store delete

Supprimez un magasin de fonctionnalités.

 Extension GA
az ml feature-store list

Répertoriez tous les magasins de fonctionnalités dans un abonnement.

 Extension GA
az ml feature-store provision-network

Provisionner un réseau managé.

 Extension GA
az ml feature-store show

Afficher les détails d’un magasin de fonctionnalités.

 Extension GA
az ml feature-store update

Mettez à jour un magasin de fonctionnalités.

 Extension GA

az ml feature-store create

Créez un magasin de fonctionnalités.

Lorsqu’un magasin de fonctionnalités est créé, plusieurs ressources Azure qui seront utilisées par Azure ML sont également créées par défaut : Stockage Azure, Azure Container Registry, Azure Key Vault et Azure Application Insights. Vous pouvez utiliser plutôt des instances de ressources Azure existantes pour celles qui créent le magasin de fonctionnalités en spécifiant les ID de ressource dans le fichier YAML de configuration du magasin de fonctionnalités.

az ml feature-store create --resource-group
                           [--application-insights]
                           [--container-registry]
                           [--description]
                           [--display-name]
                           [--file]
                           [--image-build-compute]
                           [--location]
                           [--managed-network]
                           [--materialization-identity]
                           [--name]
                           [--no-wait]
                           [--not-grant-permissions]
                           [--offline-store]
                           [--primary-user-assigned-identity]
                           [--public-network-access]
                           [--set]
                           [--tags]
                           [--update-dependent-resources]

Exemples

Créez un magasin de fonctionnalités à partir d’un fichier de spécification YAML.

az ml feature-store create --file feature-store.yml --resource-group my-resource-group

Paramètres obligatoires

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--application-insights -a

ID ARM des insights d’application associés à cet espace de travail.

--container-registry -c

ID ARM du registre de conteneurs associé à cet espace de travail.

--description

Description du magasin de fonctionnalités.

--display-name

Nom complet du magasin de fonctionnalités.

--file -f

Chemin local du fichier YAML contenant la spécification feature_store Azure ML. Les documents de référence YAML pour feature_store se trouvent à l’adresse suivante : https://aka.ms/ml-cli-v2-featurestore-yaml-reference.

--image-build-compute -i

Nom de la cible de calcul à utiliser pour créer des images Docker d’environnement lorsque le registre de conteneurs se trouve derrière un réseau virtuel.

--location -l

Emplacement à utiliser pour le nouveau magasin de fonctionnalités.

--managed-network -m

Mode d’isolation réseau managé pour l’espace de travail.

--materialization-identity -t

Identité utilisée pour la connexion de magasin hors connexion/en ligne.

--name -n

Nom du magasin de fonctionnalités.

--no-wait

N’attendez pas la fin de la création du magasin de fonctionnalités.

Propriété Valeur
Valeur par défaut: False
--not-grant-permissions

Spécification des autorisations --not-grant-permissions, pour ne pas accorder l’autorisation d’identité de matérialisation au magasin de fonctionnalités (espace de travail, magasin hors connexion et magasin en ligne). La valeur par défaut est False.

Propriété Valeur
Valeur par défaut: False
--offline-store

Configuration du magasin de fonctionnalités hors connexion. l’identité matérialisation est nécessaire pour configurer le magasin hors connexion.

--primary-user-assigned-identity -p

Identificateur ARM de l’identité managée affectée par l’utilisateur principal, dans le cas où plusieurs sont spécifiés. En outre, l’identité managée par défaut pour le calcul sans cluster.

--public-network-access

Autoriser la connectivité de point de terminaison public lorsqu’un espace de travail est activé pour une liaison privée.

--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=value.

--tags

Paires clé-valeur séparées par espace pour les balises de l’objet.

--update-dependent-resources -u

En spécifiant --update_dependent_resources, donne votre consentement pour mettre à jour les ressources dépendantes du magasin de fonctionnalités. La mise à jour de la ressource Azure Container Registry ou Application Insights attachée à l’espace de travail peut interrompre la traçabilité des travaux précédents, des points de terminaison d’inférence déployés ou votre capacité à réexécuter des travaux antérieurs dans ce magasin de fonctionnalités.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az ml feature-store delete

Supprimez un magasin de fonctionnalités.

Par défaut, les ressources dépendantes associées au magasin de fonctionnalités (Stockage Azure, Azure Container Registry, Azure Key Vault, Azure Application Insights) ne sont pas supprimées. Pour les supprimer également, incluez --all-resources.

az ml feature-store delete --name
                           --resource-group
                           [--all-resources]
                           [--no-wait]
                           [--yes]

Paramètres obligatoires

--name -n

Nom du magasin de fonctionnalités Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults feature-store=<name>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--all-resources

Supprimez toutes les ressources dépendantes associées au magasin de fonctionnalités (compte de stockage Azure, Azure Container Registry, Azure Application Insights, Azure Key Vault).

Propriété Valeur
Valeur par défaut: False
--no-wait

N’attendez pas la fin de l’opération de longue durée. La valeur par défaut est False.

Propriété Valeur
Valeur par défaut: False
--yes -y

N’invitez pas à confirmer.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az ml feature-store list

Répertoriez tous les magasins de fonctionnalités dans un abonnement.

La liste des magasins de fonctionnalités peut être filtrée par groupe de ressources.

az ml feature-store list [--max-results]
                         [--resource-group]

Exemples

Répertorier tous les magasins de fonctionnalités dans un groupe de ressources

az ml feature-store list --resource-group my-resource-group

Répertoriez tous les magasins de fonctionnalités à l’aide de l’argument --query pour exécuter une requête JMESPath sur les résultats des commandes.

az ml feature-store list --query "[].{Name:name}"  --output table --resource-group my-resource-group

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--max-results -r

Nombre maximal de résultats à retourner.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az ml feature-store provision-network

Provisionner un réseau managé.

Déclenche le magasin de fonctionnalités pour approvisionner le réseau managé. La spécification de l’indicateur spark activé prépare le réseau managé de l’espace de travail pour la prise en charge de Spark. La valeur par défaut est false si elle n’est pas spécifiée, mais peut être activée ultérieurement en exécutant à nouveau cette commande avec cet indicateur. Une fois activé, il ne peut pas être désactivé.

az ml feature-store provision-network --name
                                      --resource-group
                                      [--include-spark]
                                      [--no-wait]

Exemples

Provisionner un réseau managé.

az ml feature-store provision-network --resource-group my-resource-group --name my-feature-store-name

Paramètres obligatoires

--name -n

Nom du magasin de fonctionnalités Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults feature-store=<name>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--include-spark

Boolean [true/false] pour si le réseau managé doit être provisionné pour tenir compte des travaux Spark. La valeur par défaut est false si l’indicateur n’est pas défini. Elle peut être activée ultérieurement en exécutant à nouveau cette commande avec cet indicateur.

Propriété Valeur
Valeur par défaut: False
--no-wait

N’attendez pas la fin de l’opération de longue durée. La valeur par défaut est False.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az ml feature-store show

Afficher les détails d’un magasin de fonctionnalités.

az ml feature-store show --name
                         --resource-group

Paramètres obligatoires

--name -n

Nom du magasin de fonctionnalités Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults feature-store=<name>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az ml feature-store update

Mettez à jour un magasin de fonctionnalités.

Les propriétés « description », « tags », « friendly_name » et materialization_identity peuvent être mises à jour.

az ml feature-store update --name
                           --resource-group
                           [--add]
                           [--application-insights]
                           [--container-registry]
                           [--description]
                           [--display-name]
                           [--file]
                           [--force-string]
                           [--image-build-compute]
                           [--managed-network]
                           [--materialization-identity]
                           [--no-wait]
                           [--not-grant-permissions]
                           [--primary-user-assigned-identity]
                           [--public-network-access]
                           [--remove]
                           [--set]
                           [--update-dependent-resources]

Exemples

mettez à jour un magasin de fonctionnalités à partir d’un fichier de spécification YAML.

az ml feature-store update --resource-group my-resource-group --name my-feature-store-name --file feature-store.yml

Paramètres obligatoires

--name -n

Nom du magasin de fonctionnalités Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults feature-store=<name>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
Valeur par défaut: []
--application-insights -a

ID ARM des insights d’application associés à cet espace de travail.

--container-registry -c

ID ARM du registre de conteneurs associé à cet espace de travail.

--description

Description du magasin de fonctionnalités.

--display-name

Nom complet du magasin de fonctionnalités.

--file -f

Chemin local du fichier YAML contenant la spécification feature_store Azure ML. Les documents de référence YAML pour feature_store se trouvent à l’adresse suivante : https://aka.ms/ml-cli-v2-featurestore-yaml-reference.

--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
Valeur par défaut: False
--image-build-compute -i

Nom de la cible de calcul à utiliser pour créer des images Docker d’environnement lorsque le registre de conteneurs se trouve derrière un réseau virtuel.

--managed-network -m

Mode d’isolation réseau managé pour l’espace de travail.

--materialization-identity -t

Identité utilisée pour la connexion de magasin hors connexion/en ligne.

--no-wait

N’attendez pas la fin de l’opération de longue durée. La valeur par défaut est False.

Propriété Valeur
Valeur par défaut: False
--not-grant-permissions

Spécification des autorisations --not-grant-permissions, pour ne pas accorder l’autorisation d’identité de matérialisation au magasin de fonctionnalités (espace de travail, magasin hors connexion et magasin en ligne). La valeur par défaut est False.

Propriété Valeur
Valeur par défaut: False
--primary-user-assigned-identity -p

ID ARM de l’identité affectée par l’utilisateur principal associée à cet espace de travail.

--public-network-access

Autoriser la connectivité de point de terminaison public lorsqu’un espace de travail est activé pour une liaison privée.

--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
Valeur par défaut: []
--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
Valeur par défaut: []
--update-dependent-resources -u

En spécifiant --update_dependent_resources, donne votre consentement pour mettre à jour les ressources dépendantes de l’espace de travail. La mise à jour de la ressource Azure Container Registry ou Application Insights attachée à l’espace de travail peut interrompre la traçabilité des travaux précédents, des points de terminaison d’inférence déployés ou votre capacité à réexécuter des travaux antérieurs dans cet espace de travail.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False