ComputeTarget Klasse

Referenz

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: ABC

ComputeTarget

Konstruktor

ComputeTarget(workspace, name)

Parameter

Name	Beschreibung
workspace Erforderlich	Workspace Das Workspace-Objekt, das das abzurufende Compute-Objekt enthält.
name Erforderlich	str Der Name des abzurufenden Compute-Objekts.
workspace Erforderlich	Workspace 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	Workspace 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	ComputeTargetAttachConfiguration Ein ComputeTargetAttachConfiguration-Objekt, das verwendet wird, um den Typ des anzufügenden Compute-Objekts und seine Konfiguration zu bestimmen.

Gibt zurück

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

Ausnahmen

Typ	Beschreibung
ComputeTargetException

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	Workspace 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	ComputeTargetProvisioningConfiguration Ein ComputeTargetProvisioningConfiguration-Objekt, das verwendet wird, um den Typ des bereitzustellenden Compute-Objekts und seine Konfiguration zu bestimmen.

Gibt zurück

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

Ausnahmen

Typ	Beschreibung
ComputeTargetException

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
ComputeTargetException

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	Workspace Das Workspace-Objekt, dem das Compute-Objekt zugeordnet ist.
object_dict Erforderlich	dict Ein JSON-Objekt, das in ein Compute-Objekt konvertiert werden soll.

Gibt zurück

Typ	Beschreibung
ComputeTarget	Die Compute-Darstellung des bereitgestellten JSON-Objekts.

Ausnahmen

Typ	Beschreibung
ComputeTargetException

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
ComputeTargetException

get_status

Abrufen des aktuellen Bereitstellungsstatus des Compute-Objekts.

get_status()

Gibt zurück

Typ	Beschreibung
str	Der aktuelle `provisioning_state`.

Ausnahmen

Typ	Beschreibung
ComputeTargetException

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	Workspace Das Workspace-Objekt, das die aufzulistenden Objekte enthält.

Gibt zurück

Typ	Beschreibung
list[ComputeTarget]	Eine Liste der Computeziele innerhalb des Arbeitsbereichs.

Ausnahmen

Typ	Beschreibung
ComputeTargetException

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
ComputeTargetException

serialize

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

abstract serialize()

Gibt zurück

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

Ausnahmen

Typ	Beschreibung
ComputeTargetException

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	bool Gibt an, ob eine ausführlichere Ausgabe benötigt wird. Standardwert: False
is_delete_operation	bool Gibt an, ob es sich um einen Löschvorgang handelt. Standardwert: False

Ausnahmen

Typ	Beschreibung
ComputeTargetException

Freigeben über

ComputeTarget Klasse

Konstruktor

Parameter

Hinweise

Methoden

attach

Parameter

Gibt zurück

Ausnahmen

Hinweise

create

Parameter

Gibt zurück

Ausnahmen

Hinweise

delete

Ausnahmen

Hinweise

deserialize

Parameter

Gibt zurück

Ausnahmen

Hinweise

detach

Ausnahmen

get_status

Gibt zurück

Ausnahmen

Hinweise

list

Parameter

Gibt zurück

Ausnahmen

refresh_state

Ausnahmen

serialize

Gibt zurück

Ausnahmen

wait_for_completion

Parameter

Ausnahmen

Feedback

Zusätzliche Ressourcen