Freigeben über


ComputeTarget Klasse

Abstrakte übergeordnete Klasse für alle Computeziele, die von Azure Machine Learning verwaltet werden.

Ein Computeziel ist eine festgelegte Computeressource/-Umgebung, in der Ihr Trainingsskript ausgeführt oder Ihre Dienstbereitstellung gehostet wird. Hierbei kann es sich um Ihren lokalen Computer oder eine cloudbasierte Computeressource handeln. 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
ComputeTarget

Konstruktor

ComputeTarget(workspace, name)

Parameter

Name Beschreibung
workspace
Erforderlich

Das Workspace-Objekt, das das abzurufende Compute-Objekt enthält.

name
Erforderlich
str

Der Name des abzurufenden Compute-Objekts.

workspace
Erforderlich

Das Workspace-Objekt, das das abzurufende Compute-Objekt enthält.

name
Erforderlich
str

Der Name des abzurufenden Compute-Objekts.

Hinweise

Verwenden Sie den ComputeTarget-Konstruktor, um die Clouddarstellung eines Compute-Objekts abzurufen, das dem bereitgestellten Arbeitsbereich zugeordnet ist. Der Konstruktor gibt eine Instanz einer untergeordneten Klasse zurück, die dem jeweiligen Typ des abgerufenen Compute-Objekts entspricht. Wird das Compute-Objekt nicht gefunden, wird eine Ausnahme vom Typ ComputeTargetException ausgelöst.

Methoden

attach

Anfügen eines Compute-Objekts an einen Arbeitsbereich unter Verwendung des angegebenen Namens und der angegebenen Konfigurationsinformationen.

create

Bereitstellen eines Compute-Objekts durch Angabe eines Computetyps und der zugehörigen Konfiguration.

Diese Methode erstellt ein neues Computeziel, anstatt ein vorhandenes Computeziel anzufügen.

delete

Entfernen des Compute-Objekts aus dem zugeordneten Arbeitsbereich.

Diese abstrakte Methode wird von untergeordneten Klassen von ComputeTarget implementiert.

deserialize

Konvertieren eines JSON-Objekts in ein Compute-Objekt.

detach

Trennen des Compute-Objekts vom zugeordneten Arbeitsbereich.

Diese abstrakte Methode wird von untergeordneten Klassen von ComputeTarget implementiert. Zugrunde liegende Cloudobjekte werden nicht gelöscht. Nur die Zuordnungen werden entfernt.

get_status

Abrufen des aktuellen Bereitstellungsstatus des Compute-Objekts.

list

Auflisten aller ComputeTarget-Objekte innerhalb des Arbeitsbereichs.

Dient zum Zurückgeben einer Liste instanziierter untergeordneter Objekte, die dem jeweiligen Computetyp entsprechen. Die Objekte sind untergeordnete Elemente von ComputeTarget.

refresh_state

Direktes Aktualisieren der Eigenschaften des Objekts.

Aktualisiert Eigenschaften basierend auf dem aktuellen Zustand des entsprechenden Cloudobjekts. Dies ist hilfreich für den manuellen Abruf des Computezustands.

Diese abstrakte Methode wird von untergeordneten Klassen von ComputeTarget implementiert.

serialize

Konvertieren dieses Compute-Objekts in ein serialisiertes JSON-Wörterbuch.

wait_for_completion

Warten, bis der aktuelle Bereitstellungsvorgang im Cluster abgeschlossen ist.

Diese Methode gibt eine Ausnahme vom Typ ComputeTargetException zurück, wenn beim Abfragen des Compute-Objekts ein Problem auftritt.

attach

Anfügen eines Compute-Objekts an einen Arbeitsbereich unter Verwendung des angegebenen Namens und der angegebenen Konfigurationsinformationen.

static attach(workspace, name, attach_configuration)

Parameter

Name Beschreibung
workspace
Erforderlich

Das Workspace-Objekt, an das das Compute-Objekt angefügt werden soll.

name
Erforderlich
str

Der Name, der dem Compute-Objekt zugeordnet werden soll.

attach_configuration
Erforderlich

Ein ComputeTargetAttachConfiguration-Objekt, das verwendet wird, um den Typ des anzufügenden Compute-Objekts und seine Konfiguration zu bestimmen.

Gibt zurück

Typ Beschreibung

Eine Instanz eines untergeordneten Elements von ComputeTarget, die dem Typ des angefügten Objekts entspricht.

Ausnahmen

Typ Beschreibung

Hinweise

An den Parameter attach_configuration wird ein Objekt vom Typ ComputeTargetAttachConfiguration übergeben, das mithilfe der attach_configuration-Funktion in einer der untergeordneten Klassen von ComputeTarget erstellt wird.

Im folgenden Beispiel wird ein Azure Data Lake Analytics (ADLA)-Konto mithilfe der AdlaCompute-Methode attach_configuration 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.

create

Bereitstellen eines Compute-Objekts durch Angabe eines Computetyps und der zugehörigen Konfiguration.

Diese Methode erstellt ein neues Computeziel, anstatt ein vorhandenes Computeziel anzufügen.

static create(workspace, name, provisioning_configuration)

Parameter

Name Beschreibung
workspace
Erforderlich

Das Workspace-Objekt, unter dem das Compute-Objekt erstellt werden soll.

name
Erforderlich
str

Der Name, der dem Compute-Objekt zugeordnet werden soll.

provisioning_configuration
Erforderlich

Ein ComputeTargetProvisioningConfiguration-Objekt, das verwendet wird, um den Typ des bereitzustellenden Compute-Objekts und seine Konfiguration zu bestimmen.

Gibt zurück

Typ Beschreibung

Eine Instanz eines untergeordneten Elements von ComputeTarget, die dem Typ des bereitgestellten Objekts entspricht.

Ausnahmen

Typ Beschreibung

Hinweise

Der Typ des bereitgestellten Objekts wird durch die Bereitstellungskonfiguration bestimmt.

Im folgenden Beispiel wird ein persistentes, von AmlCompute bereitgestelltes Computeziel erstellt. Bei dem provisioning_configuration-Parameter in diesem Beispiel handelt es sich um einen Parameter vom Typ AmlComputeProvisioningConfiguration.


   from azureml.core.compute import ComputeTarget, AmlCompute
   from azureml.core.compute_target import ComputeTargetException

   # Choose a name for your CPU cluster
   cpu_cluster_name = "cpu-cluster"

   # Verify that cluster does not exist already
   try:
       cpu_cluster = ComputeTarget(workspace=ws, name=cpu_cluster_name)
       print('Found existing cluster, use it.')
   except ComputeTargetException:
       compute_config = AmlCompute.provisioning_configuration(vm_size='STANDARD_D2_V2',
                                                              max_nodes=4)
       cpu_cluster = ComputeTarget.create(ws, cpu_cluster_name, compute_config)

   cpu_cluster.wait_for_completion(show_output=True)

Das vollständige Beispiel finden Sie unter https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb.

delete

Entfernen des Compute-Objekts aus dem zugeordneten Arbeitsbereich.

Diese abstrakte Methode wird von untergeordneten Klassen von ComputeTarget implementiert.

abstract delete()

Ausnahmen

Typ Beschreibung

Hinweise

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 Ausnahme ausgelöst, und es wird nichts geändert.

deserialize

Konvertieren eines JSON-Objekts in ein Compute-Objekt.

abstract static deserialize(workspace, object_dict)

Parameter

Name Beschreibung
workspace
Erforderlich

Das Workspace-Objekt, dem das Compute-Objekt zugeordnet ist.

object_dict
Erforderlich

Ein JSON-Objekt, das in ein Compute-Objekt konvertiert werden soll.

Gibt zurück

Typ Beschreibung

Die Compute-Darstellung des bereitgestellten JSON-Objekts.

Ausnahmen

Typ Beschreibung

Hinweise

Wenn der bereitgestellte Arbeitsbereich nicht der Arbeitsbereich ist, dem das Compute-Objekt zugeordnet ist, wird eine Ausnahme vom Typ ComputeTargetException ausgelöst.

detach

Trennen des Compute-Objekts vom zugeordneten Arbeitsbereich.

Diese abstrakte Methode wird von untergeordneten Klassen von ComputeTarget implementiert. Zugrunde liegende Cloudobjekte werden nicht gelöscht. Nur die Zuordnungen werden entfernt.

abstract detach()

Ausnahmen

Typ Beschreibung

get_status

Abrufen des aktuellen Bereitstellungsstatus des Compute-Objekts.

get_status()

Gibt zurück

Typ Beschreibung
str

Der aktuelle provisioning_state.

Ausnahmen

Typ Beschreibung

Hinweise

Die zurückgegebenen Werte sind in der Azure-REST-API-Referenz für ProvisioningState aufgeführt.

list

Auflisten aller ComputeTarget-Objekte innerhalb des Arbeitsbereichs.

Dient zum Zurückgeben einer Liste instanziierter untergeordneter Objekte, die dem jeweiligen Computetyp entsprechen. Die Objekte sind untergeordnete Elemente von ComputeTarget.

static list(workspace)

Parameter

Name Beschreibung
workspace
Erforderlich

Das Workspace-Objekt, das die aufzulistenden Objekte enthält.

Gibt zurück

Typ Beschreibung

Eine Liste der Computeziele innerhalb des Arbeitsbereichs.

Ausnahmen

Typ Beschreibung

refresh_state

Direktes Aktualisieren der Eigenschaften des Objekts.

Aktualisiert Eigenschaften basierend auf dem aktuellen Zustand des entsprechenden Cloudobjekts. Dies ist hilfreich für den manuellen Abruf des Computezustands.

Diese abstrakte Methode wird von untergeordneten Klassen von ComputeTarget implementiert.

abstract refresh_state()

Ausnahmen

Typ Beschreibung

serialize

Konvertieren dieses Compute-Objekts in ein serialisiertes JSON-Wörterbuch.

abstract serialize()

Gibt zurück

Typ Beschreibung

Die JSON-Darstellung dieses Compute-Objekts.

Ausnahmen

Typ Beschreibung

wait_for_completion

Warten, bis der aktuelle Bereitstellungsvorgang im Cluster abgeschlossen ist.

Diese Methode gibt eine Ausnahme vom Typ ComputeTargetException zurück, wenn beim Abfragen des Compute-Objekts ein Problem auftritt.

wait_for_completion(show_output=False, is_delete_operation=False)

Parameter

Name Beschreibung
show_output

Gibt an, ob eine ausführlichere Ausgabe benötigt wird.

Standardwert: False
is_delete_operation

Gibt an, ob es sich um einen Löschvorgang handelt.

Standardwert: False

Ausnahmen

Typ Beschreibung