HDInsightCompute Klasse

Verwaltet ein HDInsight-Cluster-Computeziel in Azure Machine Learning.

Azure HDInsight ist eine beliebte Plattform für Big Data-Analysen. Die Plattform stellt Apache Spark bereit, das zum Training Ihres Modells verwendet werden kann. Weitere Informationen finden Sie unter Was sind Computeziele in Azure Machine Learning?

Class ComputeTarget-Konstruktor.

Rufen Sie eine Clouddarstellung eines Compute-Objekts ab, das dem bereitgestellten Arbeitsbereich zugeordnet ist. Gibt eine Instanz einer untergeordneten Klasse zurück, die dem spezifischen Typ des abgerufenen Compute-Objekts entspricht.

Konstruktor

HDInsightCompute(workspace, name)

Parameter

Name	Beschreibung
workspace Erforderlich	Workspace Das Arbeitsbereichsobjekt, das das abzurufende HDInsightCompute-Objekt enthält.
name Erforderlich	str Der Name des abzurufenden HDInsightCompute-Objekts.
workspace Erforderlich	Workspace Das Arbeitsbereichsobjekt, das das compute-Objekt enthält, das abgerufen werden soll.
name Erforderlich	str Der Name des abzurufenden Compute-Objekts.

Hinweise

Das folgende Beispiel zeigt, wie Sie einen Spark für HDInsight-Cluster in Azure erstellen.


   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)

Vollständiges Beispiel ist verfügbar von https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-in-spark/train-in-spark.ipynb

Methoden

attach	VERALTET. Verwenden Sie stattdessen die `attach_configuration` Methode. Ordnen Sie eine vorhandene HDI-Ressource dem bereitgestellten Arbeitsbereich zu.
attach_configuration	Erstellen Sie ein Konfigurationsobjekt zum Anfügen eines HDInsight-Computeziels. Das Anfügen eines HDInsight-Clusters mithilfe der öffentlichen Adresse des HDInsight-Clusters wird nicht mehr unterstützt. Verwenden Sie stattdessen resourceId des HDInsight-Clusters. Die resourceId des HDInsight-Clusters kann mit dem folgenden Zeichenfolgenformat erstellt werden: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.HDInsight/clusters/<cluster_name>". Sie können auch subscription_id, resource_group und cluster_name verwenden, ohne resourceId zu erstellen. Weitere Informationen: https://aka.ms/azureml-compute-hdi
delete	Das Löschen wird für das HDInsightCompute-Objekt nicht unterstützt. Verwenden Sie stattdessen detach.
deserialize	Konvertieren Sie ein JSON-Objekt in ein HDInsightCompute-Objekt.
detach	Trennt das HDInsightCompute-Objekt vom zugeordneten Arbeitsbereich. Zugrunde liegende Cloudobjekte werden nicht gelöscht, nur die Zuordnung wird entfernt.
get_credentials	Rufen Sie die Anmeldeinformationen für das HDInsightCompute-Ziel ab.
refresh_state	Führen Sie eine direkte Aktualisierung der Eigenschaften des Objekts durch. Diese Methode aktualisiert die Eigenschaften basierend auf dem aktuellen Zustand des entsprechenden Cloudobjekts. Dies wird in erster Linie für die manuelle Abfrage des Berechnungszustands verwendet.
serialize	Konvertieren Sie dieses HDInsightCompute-Objekt in ein serialisiertes JSON-Wörterbuch.

attach

VERALTET. Verwenden Sie stattdessen die attach_configuration Methode.

Ordnen Sie eine vorhandene HDI-Ressource dem bereitgestellten Arbeitsbereich zu.

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

Parameter

Name	Beschreibung
workspace Erforderlich	Workspace Das Arbeitsbereichsobjekt, dem die Computeressource zugeordnet werden soll.
name Erforderlich	str Der Name, der der Computeressource innerhalb des bereitgestellten Arbeitsbereichs zugeordnet werden soll. Muss nicht mit dem Namen der compute-Ressource übereinstimmen, die angefügt werden soll.
username Erforderlich	str Der Benutzername, der für den Zugriff auf die Ressource erforderlich ist.
address Erforderlich	str Die Adresse der ressource, die angefügt werden soll.
ssh_port	int Der verfügbar gemachte Port für die Ressource. Standardwert ist 22. Standardwert: 22
password Erforderlich	str Das Kennwort, das für den Zugriff auf die Ressource erforderlich ist.
private_key_file Erforderlich	str Der Pfad zu einer Datei, die den privaten Schlüssel für die Ressource enthält.
private_key_passphrase Erforderlich	str Der private Schlüsselausdruck, der für den Zugriff auf die Ressource erforderlich ist.

Gibt zurück

Typ	Beschreibung
HDInsightCompute	Eine HDInsightCompute-Objektdarstellung des Computeobjekts.

Ausnahmen

Typ	Beschreibung
ComputeTargetException

attach_configuration

Erstellen Sie ein Konfigurationsobjekt zum Anfügen eines HDInsight-Computeziels.

Das Anfügen eines HDInsight-Clusters mithilfe der öffentlichen Adresse des HDInsight-Clusters wird nicht mehr unterstützt. Verwenden Sie stattdessen resourceId des HDInsight-Clusters. Die resourceId des HDInsight-Clusters kann mit dem folgenden Zeichenfolgenformat erstellt werden: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.HDInsight/clusters/<cluster_name>".

Sie können auch subscription_id, resource_group und cluster_name verwenden, ohne resourceId zu erstellen. Weitere Informationen: 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='')

Parameter

Name	Beschreibung
username Erforderlich	str Der Benutzername, der für den Zugriff auf die Ressource erforderlich ist.
subscription_id	str Die Azure-Abonnement-ID Standardwert: None
resource_group	str Name der Ressourcengruppe, in der sich der HDI-Cluster befindet. Standardwert: None
cluster_name	str Der HDI-Clustername Standardwert: None
resource_id	str Die Ressourcen-ID des Azure Resource Manager (ARM) für die ressource, die angefügt werden soll. Standardwert: None
address	str Die Adresse für die Ressource, die angefügt werden soll. Standardwert: None
ssh_port	int Der verfügbar gemachte Port für die Ressource. Standardwert ist 22. Standardwert: 22
password Erforderlich	str Das Kennwort, das für den Zugriff auf die Ressource erforderlich ist.
private_key_file Erforderlich	str Der Pfad zu einer Datei, die den privaten Schlüssel für die Ressource enthält.
private_key_passphrase Erforderlich	str Der private Schlüsselausdruck, der für den Zugriff auf die Ressource erforderlich ist.

Gibt zurück

Typ	Beschreibung
HDInsightAttachConfiguration	Ein Konfigurationsobjekt, das beim Anfügen eines Compute-Objekts verwendet werden soll.

delete

Das Löschen wird für das HDInsightCompute-Objekt nicht unterstützt. Verwenden Sie stattdessen detach.

delete()

Ausnahmen

Typ	Beschreibung
ComputeTargetException

deserialize

Konvertieren Sie ein JSON-Objekt in ein HDInsightCompute-Objekt.

static deserialize(workspace, object_dict)

Parameter

Name	Beschreibung
workspace Erforderlich	Workspace Das Arbeitsbereichsobjekt, dem das HDInsightCompute-Objekt zugeordnet ist.
object_dict Erforderlich	dict Ein JSON-Objekt, das in ein HDInsightCompute-Objekt konvertiert werden soll.

Gibt zurück

Typ	Beschreibung
HDInsightCompute	Die HDInsightCompute-Darstellung des bereitgestellten JSON-Objekts.

Ausnahmen

Typ	Beschreibung
ComputeTargetException

Hinweise

Löst ein ComputeTargetException , wenn der bereitgestellte Arbeitsbereich nicht der Arbeitsbereich ist, dem die Compute zugeordnet ist.

detach

Trennt das HDInsightCompute-Objekt vom zugeordneten Arbeitsbereich.

Zugrunde liegende Cloudobjekte werden nicht gelöscht, nur die Zuordnung wird entfernt.

detach()

Ausnahmen

Typ	Beschreibung
ComputeTargetException

get_credentials

Rufen Sie die Anmeldeinformationen für das HDInsightCompute-Ziel ab.

get_credentials()

Gibt zurück

Typ	Beschreibung
dict	Die Anmeldeinformationen für das HDInsightCompute-Ziel

Ausnahmen

Typ	Beschreibung
ComputeTargetException

refresh_state

Führen Sie eine direkte Aktualisierung der Eigenschaften des Objekts durch.

Diese Methode aktualisiert die Eigenschaften basierend auf dem aktuellen Zustand des entsprechenden Cloudobjekts. Dies wird in erster Linie für die manuelle Abfrage des Berechnungszustands verwendet.

refresh_state()

serialize

Konvertieren Sie dieses HDInsightCompute-Objekt in ein serialisiertes JSON-Wörterbuch.

serialize()

Gibt zurück

Typ	Beschreibung
dict	Die JSON-Darstellung dieses HDICompute-Objekts.

Freigeben über

HDInsightCompute Klasse

Konstruktor

Parameter

Hinweise

Methoden

attach

Parameter

Gibt zurück

Ausnahmen

attach_configuration

Parameter

Gibt zurück

delete

Ausnahmen

deserialize

Parameter

Gibt zurück

Ausnahmen

Hinweise

detach

Ausnahmen

get_credentials

Gibt zurück

Ausnahmen

refresh_state

serialize

Gibt zurück

Feedback