HDInsightCompute Klas
Hiermee beheert u een rekendoel voor een HDInsight-cluster in Azure Machine Learning.
Azure HDInsight is een populair platform voor big data-analyses. 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.
Constructor
HDInsightCompute(workspace, name)
Parameters
| Name | Description |
|---|---|
|
workspace
Vereist
|
Het werkruimteobject met het HDInsightCompute-object dat moet worden opgehaald. |
|
name
Vereist
|
De naam van het HDInsightCompute-object dat moet worden opgehaald. |
|
workspace
Vereist
|
Het werkruimteobject met het rekenobject dat moet worden opgehaald. |
|
name
Vereist
|
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)
Volledig voorbeeld is beschikbaar vanaf https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-in-spark/train-in-spark.ipynb
Methoden
| attach |
VEROUDERD. Gebruik in plaats daarvan de 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 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 te maken. 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 |
Het HDInsightCompute-object loskoppelen 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 uit van de eigenschappen van het object. 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
VEROUDERD. 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
|
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
|
De gebruikersnaam die nodig is voor toegang tot de resource. |
|
address
Vereist
|
Het adres van de resource die moet worden gekoppeld. |
|
ssh_port
|
De weergegeven poort voor de resource. De standaardwaarde is 22. Default value: 22
|
|
password
Vereist
|
Het wachtwoord dat nodig is voor toegang tot de resource. |
|
private_key_file
Vereist
|
Het pad naar een bestand met de persoonlijke sleutel voor de resource. |
|
private_key_passphrase
Vereist
|
De woordgroep van 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 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 te maken. 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
|
De gebruikersnaam die nodig is voor toegang tot de resource. |
|
subscription_id
|
De Azure-abonnements-id Default value: None
|
|
resource_group
|
Naam van de resourcegroep waarin het HDI-cluster zich bevindt. Default value: None
|
|
cluster_name
|
De naam van het HDI-cluster Default value: None
|
|
resource_id
|
De resource-id van Azure Resource Manager (ARM) voor de resource die moet worden gekoppeld. Default value: None
|
|
address
|
Het adres waaraan de resource moet worden gekoppeld. Default value: None
|
|
ssh_port
|
De weergegeven poort voor de resource. De standaardwaarde is 22. Default value: 22
|
|
password
Vereist
|
Het wachtwoord dat nodig is voor toegang tot de resource. |
|
private_key_file
Vereist
|
Het pad naar een bestand met de persoonlijke sleutel voor de resource. |
|
private_key_passphrase
Vereist
|
De woordgroep van 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. |
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 waarmee het HDInsightCompute-object is gekoppeld. |
|
object_dict
Vereist
|
Een JSON-object dat moet worden geconverteerd naar een HDInsightCompute-object. |
Retouren
| Type | Description |
|---|---|
|
De HDInsightCompute-weergave van het opgegeven JSON-object. |
Uitzonderingen
| Type | Description |
|---|---|
Opmerkingen
Hiermee wordt een ComputeTargetException opgegeven als de opgegeven werkruimte niet de werkruimte is waarmee compute is gekoppeld.
detach
Het HDInsightCompute-object loskoppelen 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 uit van de eigenschappen van het object.
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()
serialize
Converteer dit HDInsightCompute-object naar een geserialiseerde JSON-woordenlijst.
serialize()
Retouren
| Type | Description |
|---|---|
|
De JSON-weergave van dit HDICompute-object. |