az ml feature-store

  • Référence

Remarque

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 commande az ml feature-store . En savoir plus 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 Statut
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 Recommandations. 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--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 sont disponibles à 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.

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.

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=.

--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 Recommandations Application 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.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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 Recommandations) 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 az configure --defaults feature-store=<name>de .

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--all-resources

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

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.

valeur par défaut: False
--yes -y

Ne pas demander de confirmation.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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

--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 en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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 az configure --defaults feature-store=<name>de .

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--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.

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.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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 az configure --defaults feature-store=<name>de .

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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 az configure --defaults feature-store=<name>de .

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--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>.

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 sont disponibles à 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.

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.

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.

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.

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>.

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 Recommandations Application 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.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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