Delen via


HDInsightCompute Klas

Hiermee beheert u een rekendoel voor een HDInsight-cluster in Azure Machine Learning.

Azure HDInsight is een populair platform voor big data-analyse. Het platform biedt Apache Spark, dat kan worden gebruikt om uw model te trainen. Zie Wat zijn rekendoelen in Azure Machine Learning? voor meer informatie.

Klasse ComputeTarget-constructor.

Haal een cloudweergave op van een compute-object dat is gekoppeld aan de opgegeven werkruimte. Retourneert een exemplaar van een onderliggende klasse die overeenkomt met het specifieke type van het opgehaalde Compute-object.

Overname
HDInsightCompute

Constructor

HDInsightCompute(workspace, name)

Parameters

Name Description
workspace
Vereist

Het werkruimteobject met het HDInsightCompute-object dat moet worden opgehaald.

name
Vereist
str

De naam van de van het HDInsightCompute-object dat moet worden opgehaald.

workspace
Vereist

Het werkruimteobject met het rekenobject dat moet worden opgehaald.

name
Vereist
str

De naam van het rekenobject dat moet worden opgehaald.

Opmerkingen

In het volgende voorbeeld ziet u hoe u een Spark voor HDInsight-cluster maakt in 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)

Het volledige voorbeeld is beschikbaar via https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-in-spark/train-in-spark.ipynb

Methoden

attach

AFGEKEURD. Gebruik in plaats daarvan de attach_configuration methode.

Koppel een bestaande HDI-resource aan de opgegeven werkruimte.

attach_configuration

Maak een configuratieobject voor het koppelen van een HDInsight-rekendoel.

Het koppelen van een HDInsight-cluster met behulp van het openbare adres van het HDInsight-cluster wordt niet meer ondersteund. Gebruik in plaats daarvan resourceId van het HDInsight-cluster. De resourceId van het HDInsight-cluster kan worden samengesteld met behulp van de volgende tekenreeksindeling: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.HDInsight/clusters/<cluster_name>".

U kunt ook subscription_id, resource_group en cluster_name gebruiken zonder resourceId samen te stellen. Voor meer informatie: https://aka.ms/azureml-compute-hdi

delete

Verwijderen wordt niet ondersteund voor HDInsightCompute-object. Gebruik in plaats daarvan detach.

deserialize

Converteer een JSON-object naar een HDInsightCompute-object.

detach

Koppelt het HDInsightCompute-object los van de bijbehorende werkruimte.

Onderliggende cloudobjecten worden niet verwijderd, alleen de koppeling wordt verwijderd.

get_credentials

Haal de referenties voor het HDInsightCompute-doel op.

refresh_state

Voer een in-place update van de eigenschappen van het object uit.

Met deze methode worden de eigenschappen bijgewerkt op basis van de huidige status van het bijbehorende cloudobject. Dit wordt voornamelijk gebruikt voor handmatige polling van de rekenstatus.

serialize

Converteer dit HDInsightCompute-object naar een geserialiseerde JSON-woordenlijst.

attach

AFGEKEURD. Gebruik in plaats daarvan de attach_configuration methode.

Koppel een bestaande HDI-resource aan de opgegeven werkruimte.

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

Parameters

Name Description
workspace
Vereist

Het werkruimteobject waaraan de rekenresource moet worden gekoppeld.

name
Vereist
str

De naam die moet worden gekoppeld aan de rekenresource in de opgegeven werkruimte. Hoeft niet overeen te komen met de naam van de rekenresource die moet worden gekoppeld.

username
Vereist
str

De gebruikersnaam die nodig is voor toegang tot de resource.

address
Vereist
str

Het adres van de resource die moet worden gekoppeld.

ssh_port
int

De weergegeven poort voor de resource. De standaardwaarde is 22.

Default value: 22
password
Vereist
str

Het wachtwoord dat nodig is voor toegang tot de resource.

private_key_file
Vereist
str

Het pad naar een bestand met de persoonlijke sleutel voor de resource.

private_key_passphrase
Vereist
str

De woordgroep met de persoonlijke sleutel die nodig is voor toegang tot de resource.

Retouren

Type Description

Een HDInsightCompute-objectweergave van het rekenobject.

Uitzonderingen

Type Description

attach_configuration

Maak een configuratieobject voor het koppelen van een HDInsight-rekendoel.

Het koppelen van een HDInsight-cluster met behulp van het openbare adres van het HDInsight-cluster wordt niet meer ondersteund. Gebruik in plaats daarvan resourceId van het HDInsight-cluster. De resourceId van het HDInsight-cluster kan worden samengesteld met behulp van de volgende tekenreeksindeling: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.HDInsight/clusters/<cluster_name>".

U kunt ook subscription_id, resource_group en cluster_name gebruiken zonder resourceId samen te stellen. Voor meer informatie: 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='')

Parameters

Name Description
username
Vereist
str

De gebruikersnaam die nodig is voor toegang tot de resource.

subscription_id
str

De azure-abonnements-id

Default value: None
resource_group
str

Naam van de resourcegroep waarin het HDI-cluster zich bevindt.

Default value: None
cluster_name
str

De naam van het HDI-cluster

Default value: None
resource_id
str

De ARM-resource-id (Azure Resource Manager) voor de resource die moet worden gekoppeld.

Default value: None
address
str

Het adres voor de resource die moet worden gekoppeld.

Default value: None
ssh_port
int

De weergegeven poort voor de resource. De standaardwaarde is 22.

Default value: 22
password
Vereist
str

Het wachtwoord dat nodig is voor toegang tot de resource.

private_key_file
Vereist
str

Het pad naar een bestand met de persoonlijke sleutel voor de resource.

private_key_passphrase
Vereist
str

De woordgroep met de persoonlijke sleutel die nodig is voor toegang tot de resource.

Retouren

Type Description

Een configuratieobject dat moet worden gebruikt bij het koppelen van een compute-object.

Uitzonderingen

Type Description

delete

Verwijderen wordt niet ondersteund voor HDInsightCompute-object. Gebruik in plaats daarvan detach.

delete()

Uitzonderingen

Type Description

deserialize

Converteer een JSON-object naar een HDInsightCompute-object.

static deserialize(workspace, object_dict)

Parameters

Name Description
workspace
Vereist

Het werkruimteobject waar het HDInsightCompute-object aan is gekoppeld.

object_dict
Vereist

Een JSON-object om te converteren naar een HDInsightCompute-object.

Retouren

Type Description

De HDInsightCompute-weergave van het opgegeven JSON-object.

Uitzonderingen

Type Description

Opmerkingen

Genereert een ComputeTargetException als de opgegeven werkruimte niet de werkruimte is waar de compute aan is gekoppeld.

detach

Koppelt het HDInsightCompute-object los van de bijbehorende werkruimte.

Onderliggende cloudobjecten worden niet verwijderd, alleen de koppeling wordt verwijderd.

detach()

Uitzonderingen

Type Description

get_credentials

Haal de referenties voor het HDInsightCompute-doel op.

get_credentials()

Retouren

Type Description

De referenties voor het HDInsightCompute-doel

Uitzonderingen

Type Description

refresh_state

Voer een in-place update van de eigenschappen van het object uit.

Met deze methode worden de eigenschappen bijgewerkt op basis van de huidige status van het bijbehorende cloudobject. Dit wordt voornamelijk gebruikt voor handmatige polling van de rekenstatus.

refresh_state()

Uitzonderingen

Type Description

serialize

Converteer dit HDInsightCompute-object naar een geserialiseerde JSON-woordenlijst.

serialize()

Retouren

Type Description

De JSON-weergave van dit HDICompute-object.

Uitzonderingen

Type Description