AdlaCompute Klasse
Verwaltet ein Azure Data Lake Analytics-Computeziel in Azure Machine Learning.
Azure Data Lake Analytics ist eine umfangreiche Datenanalyseplattform in der Azure-Cloud. Sie kann in Azure Machine Learning-Pipelines als Computeziel verwendet werden. Weitere Informationen finden Sie unter Was sind Computeziele in Azure Machine Learning?.
ComputeTarget-Konstruktor der Klasse.
Rufen Sie eine Clouddarstellung eines Compute-Objekts ab, das dem bereitgestellten Arbeitsbereich zugeordnet ist. Gibt einen instance einer untergeordneten Klasse zurück, die dem spezifischen Typ des abgerufenen Compute-Objekts entspricht.
- Vererbung
-
AdlaCompute
Konstruktor
AdlaCompute(workspace, name)
Parameter
Name | Beschreibung |
---|---|
workspace
Erforderlich
|
Das Arbeitsbereichsobjekt, das das abzurufende AdlaCompute-Objekt enthält. |
name
Erforderlich
|
Der Name des abzurufenden AdlaCompute-Objekts. |
workspace
Erforderlich
|
Das Workspace-Objekt, das das abzurufende Compute-Objekt enthält. |
name
Erforderlich
|
Der Name des abzurufenden Compute-Objekts. |
Hinweise
Erstellen Sie vor der Verwendung ein Azure Data Lake Analytics-Konto. Informationen zur Erstellung finden Sie unter Erste Schritte mit Azure Data Lake Analytics.
Im folgenden Beispiel wird ein ADLA-Konto mithilfe der attach_configuration-Methode an einen Arbeitsbereich angefügt.
adla_compute_name = 'testadl' # Name to associate with new compute in workspace
# ADLA account details needed to attach as compute to workspace
adla_account_name = "<adla_account_name>" # Name of the Azure Data Lake Analytics account
adla_resource_group = "<adla_resource_group>" # Name of the resource group which contains this account
try:
# check if already attached
adla_compute = AdlaCompute(ws, adla_compute_name)
except ComputeTargetException:
print('attaching adla compute...')
attach_config = AdlaCompute.attach_configuration(resource_group=adla_resource_group, account_name=adla_account_name)
adla_compute = ComputeTarget.attach(ws, adla_compute_name, attach_config)
adla_compute.wait_for_completion()
print("Using ADLA compute:{}".format(adla_compute.cluster_resource_id))
print("Provisioning state:{}".format(adla_compute.provisioning_state))
print("Provisioning errors:{}".format(adla_compute.provisioning_errors))
Das vollständige Beispiel finden Sie unter https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/machine-learning-pipelines/intro-to-pipelines/aml-pipelines-use-adla-as-compute-target.ipynb
Methoden
attach |
VERALTET. Verwenden Sie stattdessen die Ordnet dem bereitgestellten Arbeitsbereich eine vorhandene Azure Data Lake Analytics-Computeressource zu. |
attach_configuration |
Erstellt ein Konfigurationsobjekt zum Anfügen eines Azure Data Lake Analytics-Computeziels. |
delete |
Entfernt das AdlaCompute-Objekt aus dem zugeordneten Arbeitsbereich. Wenn dieses Objekt über Azure Machine Learning erstellt wurde, werden auch die entsprechenden cloudbasierten Objekte gelöscht. Wenn dieses Objekt extern erstellt und nur an den Arbeitsbereich angefügt wurde, wird eine ComputeTargetException ausgelöst, und es wird nichts geändert. |
deserialize |
Konvertiert ein JSON-Objekt in ein AdlaCompute-Objekt. |
detach |
Trennt das AdlaCompute-Objekt vom zugeordneten Arbeitsbereich. Zugrunde liegende Cloudobjekte werden nicht gelöscht, nur die Zuordnung wird entfernt. |
refresh_state |
Direktes Aktualisieren der Eigenschaften des Objekts. Mit dieser Methode werden die Eigenschaften basierend auf dem aktuellen Zustand des entsprechenden Cloud-Objekts aktualisiert. Sie wird in erster Linie für den manuellen Abruf des Computezustands verwendet. |
serialize |
Konvertiert dieses AdlaCompute-Objekt in ein serialisiertes JSON-Wörterbuch. |
attach
VERALTET. Verwenden Sie stattdessen die attach_configuration
-Methode.
Ordnet dem bereitgestellten Arbeitsbereich eine vorhandene Azure Data Lake Analytics-Computeressource zu.
static attach(workspace, name, resource_id)
Parameter
Name | Beschreibung |
---|---|
workspace
Erforderlich
|
Das Arbeitsbereichsobjekt, dem die Computeressource zugeordnet werden soll. |
name
Erforderlich
|
Name, der der Computeressource innerhalb des bereitgestellten Arbeitsbereichs zugeordnet werden soll. Muss nicht mit dem Namen der anzufügenden Computeressource übereinstimmen. |
resource_id
Erforderlich
|
Die Azure-Ressourcen-ID für die angefügte Computeressource. |
Gibt zurück
Typ | Beschreibung |
---|---|
Eine AdlaCompute-Objektdarstellung des Computeobjekts. |
Ausnahmen
Typ | Beschreibung |
---|---|
attach_configuration
Erstellt ein Konfigurationsobjekt zum Anfügen eines Azure Data Lake Analytics-Computeziels.
static attach_configuration(resource_group=None, account_name=None, resource_id=None)
Parameter
Name | Beschreibung |
---|---|
resource_group
|
Der Name der Ressourcengruppe, in der sich das Data Lake Analytics-Konto befindet. Standardwert: None
|
account_name
|
Der Name des Data Lake Analytics-Kontos. Standardwert: None
|
resource_id
|
Die Azure-Ressourcen-ID für die angefügte Computeressource. Standardwert: None
|
Gibt zurück
Typ | Beschreibung |
---|---|
Ein Konfigurationsobjekt, das beim Anfügen eines Computeobjekts verwendet werden soll. |
Ausnahmen
Typ | Beschreibung |
---|---|
delete
Entfernt das AdlaCompute-Objekt aus dem zugeordneten Arbeitsbereich.
Wenn dieses Objekt über Azure Machine Learning erstellt wurde, werden auch die entsprechenden cloudbasierten Objekte gelöscht. Wenn dieses Objekt extern erstellt und nur an den Arbeitsbereich angefügt wurde, wird eine ComputeTargetException ausgelöst, und es wird nichts geändert.
delete()
Ausnahmen
Typ | Beschreibung |
---|---|
deserialize
Konvertiert ein JSON-Objekt in ein AdlaCompute-Objekt.
static deserialize(workspace, object_dict)
Parameter
Name | Beschreibung |
---|---|
workspace
Erforderlich
|
Das Arbeitsbereichsobjekt, dem das AdlaCompute-Objekt zugeordnet ist. |
object_dict
Erforderlich
|
Ein JSON-Objekt, das in ein AdlaCompute-Objekt konvertiert werden soll. |
Gibt zurück
Typ | Beschreibung |
---|---|
Die AdlaCompute-Darstellung des bereitgestellten JSON-Objekts. |
Ausnahmen
Typ | Beschreibung |
---|---|
Hinweise
Wenn der bereitgestellte Arbeitsbereich nicht der Arbeitsbereich ist, dem das Compute-Objekt zugeordnet ist, wird ComputeTargetException ausgelöst.
detach
Trennt das AdlaCompute-Objekt vom zugeordneten Arbeitsbereich.
Zugrunde liegende Cloudobjekte werden nicht gelöscht, nur die Zuordnung wird entfernt.
detach()
Ausnahmen
Typ | Beschreibung |
---|---|
refresh_state
Direktes Aktualisieren der Eigenschaften des Objekts.
Mit dieser Methode werden die Eigenschaften basierend auf dem aktuellen Zustand des entsprechenden Cloud-Objekts aktualisiert. Sie wird in erster Linie für den manuellen Abruf des Computezustands verwendet.
refresh_state()
Ausnahmen
Typ | Beschreibung |
---|---|
serialize
Konvertiert dieses AdlaCompute-Objekt in ein serialisiertes JSON-Wörterbuch.
serialize()
Gibt zurück
Typ | Beschreibung |
---|---|
Die JSON-Darstellung dieses AdlaCompute-Objekts. |
Ausnahmen
Typ | Beschreibung |
---|---|