HDInsightCompute Classe

Gère une cible de calcul de cluster HDInsight dans Azure Machine Learning.

Azure HDInsight est une plateforme populaire pour l’analytique de Big Data. Elle fournit Apache Spark, que vous pouvez utiliser pour entraîner votre modèle. Pour plus d’informations, consultez Quelles sont les cibles de calcul dans Azure Machine Learning ?

Constructeur ComputeTarget de classe.

Récupérez une représentation cloud d’un objet Compute associé à l’espace de travail fourni. Retourne une instance d’une classe enfant correspondant au type spécifique de l’objet Compute récupéré.

Constructeur

HDInsightCompute(workspace, name)

Paramètres

Nom	Description
workspace Obligatoire	Workspace Objet d’espace de travail contenant l’objet HDInsightCompute à récupérer.
name Obligatoire	str Nom de l’objet HDInsightCompute à récupérer.
workspace Obligatoire	Workspace Objet d’espace de travail contenant l’objet Compute à récupérer.
name Obligatoire	str Nom de l’objet Compute à récupérer.

Remarques

L’exemple suivant montre comment créer un cluster Spark pour HDInsight dans Azure.


   from azureml.core.compute import ComputeTarget, HDInsightCompute
   from azureml.exceptions import ComputeTargetException
   import os

   try:
   # If you want to connect using SSH key instead of username/password you can provide parameters private_key_file and private_key_passphrase

   # Attaching a HDInsight cluster using the public address of the HDInsight cluster is no longer supported.
   # Instead, use resourceId of the HDInsight cluster.
   # The resourceId of the HDInsight Cluster can be constructed using the following string format:
   # /subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.HDInsight/clusters/<cluster_name>.
   # You can also use subscription_id, resource_group and cluster_name without constructing resourceId.
       attach_config = HDInsightCompute.attach_configuration(resource_id='<resource_id>',
                                                             ssh_port=22,
                                                             username=os.environ.get('hdiusername', '<ssh_username>'),
                                                             password=os.environ.get('hdipassword', '<my_password>'))

       hdi_compute = ComputeTarget.attach(workspace=ws,
                                          name='myhdi',
                                          attach_configuration=attach_config)

   except ComputeTargetException as e:
       print("Caught = {}".format(e.message))


   hdi_compute.wait_for_completion(show_output=True)

L’exemple complet est disponible à partir de https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-in-spark/train-in-spark.ipynb

Méthodes

attach	OBSOLESCENT. Utilisez plutôt la `attach_configuration` méthode. Associez une ressource HDI existante à l’espace de travail fourni.
attach_configuration	Créez un objet de configuration pour attacher une cible de calcul HDInsight. L’attachement d’un cluster HDInsight à l’aide de l’adresse publique du cluster HDInsight n’est plus pris en charge. Utilisez plutôt resourceId du cluster HDInsight. L’ID de ressource du cluster HDInsight peut être construit à l’aide du format de chaîne suivant : « /subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.HDInsight/clusters/<cluster_name> ». Vous pouvez également utiliser subscription_id, resource_group et cluster_name sans construire resourceId. Pour plus d’informations : https://aka.ms/azureml-compute-hdi
delete	La suppression n’est pas prise en charge pour l’objet HDInsightCompute. Utilisez detach à la place.
deserialize	Convertissez un objet JSON en objet HDInsightCompute.
detach	Détache l’objet HDInsightCompute de son espace de travail associé. Les objets cloud sous-jacents ne sont pas supprimés, seule l’association est supprimée.
get_credentials	Récupérez les informations d’identification de la cible HDInsightCompute.
refresh_state	Effectuez une mise à jour sur place des propriétés de l’objet. Cette méthode met à jour les propriétés en fonction de l’état actuel de l’objet cloud correspondant. Ceci est principalement utilisé pour l’interrogation manuelle de l’état de calcul.
serialize	Convertissez cet objet HDInsightCompute en dictionnaire sérialisé JSON.

attach

OBSOLESCENT. Utilisez plutôt la attach_configuration méthode.

Associez une ressource HDI existante à l’espace de travail fourni.

static attach(workspace, name, username, address, ssh_port='22', password='', private_key_file='', private_key_passphrase='')

Paramètres

Nom	Description
workspace Obligatoire	Workspace Objet d’espace de travail auquel associer la ressource de calcul.
name Obligatoire	str Nom à associer à la ressource de calcul à l’intérieur de l’espace de travail fourni. Ne doit pas correspondre au nom de la ressource de calcul à joindre.
username Obligatoire	str Nom d’utilisateur nécessaire pour accéder à la ressource.
address Obligatoire	str Adresse de la ressource à joindre.
ssh_port	int Port exposé pour la ressource. La valeur par défaut est 22. Valeur par défaut: 22
password Obligatoire	str Mot de passe nécessaire pour accéder à la ressource.
private_key_file Obligatoire	str Chemin d’accès à un fichier contenant la clé privée de la ressource.
private_key_passphrase Obligatoire	str Expression de clé privée nécessaire pour accéder à la ressource.

Retours

Type	Description
HDInsightCompute	Représentation d’objet HDInsightCompute de l’objet de calcul.

Exceptions

Type	Description
ComputeTargetException

attach_configuration

Créez un objet de configuration pour attacher une cible de calcul HDInsight.

L’attachement d’un cluster HDInsight à l’aide de l’adresse publique du cluster HDInsight n’est plus pris en charge. Utilisez plutôt resourceId du cluster HDInsight. L’ID de ressource du cluster HDInsight peut être construit à l’aide du format de chaîne suivant : « /subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.HDInsight/clusters/<cluster_name> ».

Vous pouvez également utiliser subscription_id, resource_group et cluster_name sans construire resourceId. Pour plus d’informations : https://aka.ms/azureml-compute-hdi

static attach_configuration(username, subscription_id=None, resource_group=None, cluster_name=None, resource_id=None, address=None, ssh_port='22', password='', private_key_file='', private_key_passphrase='')

Paramètres

Nom	Description
username Obligatoire	str Nom d’utilisateur nécessaire pour accéder à la ressource.
subscription_id	str ID d’abonnement Azure Valeur par défaut: None
resource_group	str Nom du groupe de ressources dans lequel se trouve le cluster HDI. Valeur par défaut: None
cluster_name	str Nom du cluster HDI Valeur par défaut: None
resource_id	str ID de ressource Azure Resource Manager (ARM) pour la ressource à joindre. Valeur par défaut: None
address	str Adresse de la ressource à joindre. Valeur par défaut: None
ssh_port	int Port exposé pour la ressource. La valeur par défaut est 22. Valeur par défaut: 22
password Obligatoire	str Mot de passe nécessaire pour accéder à la ressource.
private_key_file Obligatoire	str Chemin d’accès à un fichier contenant la clé privée de la ressource.
private_key_passphrase Obligatoire	str Expression de clé privée nécessaire pour accéder à la ressource.

Retours

Type	Description
HDInsightAttachConfiguration	Objet de configuration à utiliser lors de l’attachement d’un objet Compute.

delete

La suppression n’est pas prise en charge pour l’objet HDInsightCompute. Utilisez detach à la place.

delete()

Exceptions

Type	Description
ComputeTargetException

deserialize

Convertissez un objet JSON en objet HDInsightCompute.

static deserialize(workspace, object_dict)

Paramètres

Nom	Description
workspace Obligatoire	Workspace L’objet d’espace de travail auquel l’objet HDInsightCompute est associé.
object_dict Obligatoire	dict Objet JSON à convertir en objet HDInsightCompute.

Retours

Type	Description
HDInsightCompute	Représentation HDInsightCompute de l’objet JSON fourni.

Exceptions

Type	Description
ComputeTargetException

Remarques

Déclenche une ComputeTargetException opération si l’espace de travail fourni n’est pas l’espace de travail associé au calcul.

detach

Détache l’objet HDInsightCompute de son espace de travail associé.

Les objets cloud sous-jacents ne sont pas supprimés, seule l’association est supprimée.

detach()

Exceptions

Type	Description
ComputeTargetException

get_credentials

Récupérez les informations d’identification de la cible HDInsightCompute.

get_credentials()

Retours

Type	Description
dict	Informations d’identification de la cible HDInsightCompute

Exceptions

Type	Description
ComputeTargetException

refresh_state

Effectuez une mise à jour sur place des propriétés de l’objet.

Cette méthode met à jour les propriétés en fonction de l’état actuel de l’objet cloud correspondant. Ceci est principalement utilisé pour l’interrogation manuelle de l’état de calcul.

refresh_state()

serialize

Convertissez cet objet HDInsightCompute en dictionnaire sérialisé JSON.

serialize()

Retours

Type	Description
dict	Représentation JSON de cet objet HDICompute.

Partager via

HDInsightCompute Classe

Constructeur

Paramètres

Remarques

Méthodes

attach

Paramètres

Retours

Exceptions

attach_configuration

Paramètres

Retours

delete

Exceptions

deserialize

Paramètres

Retours

Exceptions

Remarques

detach

Exceptions

get_credentials

Retours

Exceptions

refresh_state

serialize

Retours

Commentaires