ComputeTarget Osztály

Referencia

Absztrakt szülőosztály az Azure Machine Learning által felügyelt összes számítási célhoz.

A számítási cél egy kijelölt számítási erőforrás/környezet, ahol futtatja a betanítási szkriptet, vagy üzemelteti a szolgáltatás üzembe helyezését. Ez a hely lehet a helyi gép vagy egy felhőalapú számítási erőforrás. További információ: Mik azok a számítási célok az Azure Machine Learningben?

ComputeTarget-konstruktor osztály.

Lekérheti a megadott munkaterülethez társított számítási objektum felhőbeli ábrázolását. Egy gyermekosztály egy példányát adja vissza, amely megfelel a lekért Számítási objektum adott típusának.

Öröklődés: ABC

ComputeTarget

Konstruktor

ComputeTarget(workspace, name)

Paraméterek

Name	Description
workspace Kötelező	Workspace A lekérni kívánt Compute objektumot tartalmazó munkaterület-objektum.
name Kötelező	str A lekérni kívánt Compute-objektum neve.
workspace Kötelező	Workspace A lekérni kívánt Compute objektumot tartalmazó munkaterület-objektum.
name Kötelező	str A lekérni kívánt Compute objektum neve.

Megjegyzések

A ComputeTarget konstruktor használatával lekérheti a megadott munkaterülethez társított Számítási objektum felhőbeli ábrázolását. A konstruktor egy gyermekosztály egy példányát adja vissza, amely megfelel a lekért számítási objektum adott típusának. Ha a Compute objektum nem található, ComputeTargetException a lesz emelve.

Metódusok

attach	Számítási objektum csatolása egy munkaterülethez a megadott név és konfigurációs adatok használatával.
create	Számítási objektum kiépítése egy számítási típus és a kapcsolódó konfiguráció megadásával. Ez a metódus egy új számítási célt hoz létre ahelyett, hogy meglévőt csatol.
delete	Távolítsa el a Compute objektumot a társított munkaterületről. Ezt az absztrakt metódust a gyermekosztályai implementálják ComputeTarget.
deserialize	JSON-objektum konvertálása Számítási objektummá.
detach	Válassza le a Compute objektumot a társított munkaterületről. Ezt az absztrakt metódust a gyermekosztályai implementálják ComputeTarget. A mögöttes felhőobjektumok nem törlődnek, csak a társításuk törlődik.
get_status	Kérje le a Compute objektum aktuális kiépítési állapotát.
list	A munkaterületen belüli összes ComputeTarget-objektum listázása. Visszaadja az adott számítási típusnak megfelelő példányosított gyermekobjektumok listáját. Az objektumok a gyermekobjektumai ComputeTarget.
refresh_state	Végezze el az objektum tulajdonságainak helyben történő frissítését. Frissítse a tulajdonságokat a megfelelő felhőobjektum aktuális állapota alapján. Ez hasznos a számítási állapot manuális lekérdezéséhez. Ezt az absztrakt metódust a gyermekosztályai implementálják ComputeTarget.
serialize	Konvertálja ezt a Compute-objektumot JSON szerializált szótárlá.
wait_for_completion	Várja meg, amíg az aktuális kiépítési művelet befejeződik a fürtön. Ez a metódus egy ComputeTargetException hibát ad vissza, ha probléma merült fel a számítási objektum lekérdezése során.

attach

Számítási objektum csatolása egy munkaterülethez a megadott név és konfigurációs adatok használatával.

static attach(workspace, name, attach_configuration)

Paraméterek

Name	Description
workspace Kötelező	Workspace A compute objektumot csatolandó munkaterület-objektum.
name Kötelező	str A Compute objektumhoz társítandó név.
attach_configuration Kötelező	ComputeTargetAttachConfiguration Egy ComputeTargetAttachConfiguration objektum, amely a csatolandó Számítási objektum típusának és konfigurálásának meghatározására szolgál.

Válaszok

Típus	Description
ComputeTarget	A Csatolt objektum típusának megfelelő ComputeTarget gyermekpéldánya.

Kivételek

Típus	Description
ComputeTargetException

Megjegyzések

A paraméternek attach_configuration átadni kívánt objektum típusa egy ComputeTargetAttachConfiguration olyan objektum, amely a attach_configuration függvény használatával készült a gyermekosztályok bármelyikére ComputeTarget.

Az alábbi példa bemutatja, hogyan csatolhat ADLA-fiókot egy munkaterülethez az attach_configuration AdlaCompute metódussal.


   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))

A teljes minta a következő forrásból érhető el: 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

Számítási objektum kiépítése egy számítási típus és a kapcsolódó konfiguráció megadásával.

Ez a metódus egy új számítási célt hoz létre ahelyett, hogy meglévőt csatol.

static create(workspace, name, provisioning_configuration)

Paraméterek

Name	Description
workspace Kötelező	Workspace A compute objektum létrehozásához tartozó munkaterület-objektum.
name Kötelező	str A Compute objektumhoz társítandó név.
provisioning_configuration Kötelező	ComputeTargetProvisioningConfiguration Egy ComputeTargetProvisioningConfiguration objektum, amely a kiépítendő Számítási objektum típusának és konfigurálásának meghatározására szolgál.

Válaszok

Típus	Description
ComputeTarget	A ComputeTarget gyermekpéldánya, amely megfelel a kiépített objektum típusának.

Kivételek

Típus	Description
ComputeTargetException

Megjegyzések

A kiépített objektum típusát a megadott kiépítési konfiguráció határozza meg.

Az alábbi példában létrejön egy állandó számítási cél, amelyet a rendszer AmlCompute kiépített. A provisioning_configuration példában szereplő paraméter típusa 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)

A teljes minta a következő forrásból érhető el: https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb

delete

Távolítsa el a Compute objektumot a társított munkaterületről.

Ezt az absztrakt metódust a gyermekosztályai implementálják ComputeTarget.

abstract delete()

Kivételek

Típus	Description
ComputeTargetException

Megjegyzések

Ha ezt az objektumot az Azure Machine Learningen keresztül hozták létre, a megfelelő felhőalapú objektumok is törlődnek. Ha ez az objektum külsőleg lett létrehozva, és csak a munkaterülethez lett csatolva, ez a metódus kivételt jelez, és semmi sem változik.

deserialize

JSON-objektum konvertálása Számítási objektummá.

abstract static deserialize(workspace, object_dict)

Paraméterek

Name	Description
workspace Kötelező	Workspace Az a munkaterület-objektum, amelyhez a Compute objektum társítva van.
object_dict Kötelező	dict Egy számítási objektummá konvertálandó JSON-objektum.

Válaszok

Típus	Description
ComputeTarget	A megadott JSON-objektum számítási ábrázolása.

Kivételek

Típus	Description
ComputeTargetException

Megjegyzések

A értéket ad ComputeTargetException elő, ha a megadott munkaterület nem az a munkaterület, amelyhez a Számítás társítva van.

detach

Válassza le a Compute objektumot a társított munkaterületről.

Ezt az absztrakt metódust a gyermekosztályai implementálják ComputeTarget. A mögöttes felhőobjektumok nem törlődnek, csak a társításuk törlődik.

abstract detach()

Kivételek

Típus	Description
ComputeTargetException

get_status

Kérje le a Compute objektum aktuális kiépítési állapotát.

get_status()

Válaszok

Típus	Description
str	Az aktuális `provisioning_state`.

Kivételek

Típus	Description
ComputeTargetException

Megjegyzések

A visszaadott értékek a ProvisioningState Azure REST API-referenciájában találhatók.

list

A munkaterületen belüli összes ComputeTarget-objektum listázása.

Visszaadja az adott számítási típusnak megfelelő példányosított gyermekobjektumok listáját. Az objektumok a gyermekobjektumai ComputeTarget.

static list(workspace)

Paraméterek

Name	Description
workspace Kötelező	Workspace A listázandó objektumokat tartalmazó munkaterület-objektum.

Válaszok

Típus	Description
list[ComputeTarget]	A munkaterületen belüli számítási célok listája.

Kivételek

Típus	Description
ComputeTargetException

refresh_state

Végezze el az objektum tulajdonságainak helyben történő frissítését.

Frissítse a tulajdonságokat a megfelelő felhőobjektum aktuális állapota alapján. Ez hasznos a számítási állapot manuális lekérdezéséhez.

Ezt az absztrakt metódust a gyermekosztályai implementálják ComputeTarget.

abstract refresh_state()

Kivételek

Típus	Description
ComputeTargetException

serialize

Konvertálja ezt a Compute-objektumot JSON szerializált szótárlá.

abstract serialize()

Válaszok

Típus	Description
dict	A Compute-objektum JSON-ábrázolása.

Kivételek

Típus	Description
ComputeTargetException

wait_for_completion

Várja meg, amíg az aktuális kiépítési művelet befejeződik a fürtön.

Ez a metódus egy ComputeTargetException hibát ad vissza, ha probléma merült fel a számítási objektum lekérdezése során.

wait_for_completion(show_output=False, is_delete_operation=False)

Paraméterek

Name	Description
show_output	bool Azt jelzi, hogy adjon-e részletesebb kimenetet. Alapértelmezett érték: False
is_delete_operation	bool Azt jelzi, hogy a művelet törlésre szolgál-e. Alapértelmezett érték: False

Kivételek

Típus	Description
ComputeTargetException

Megosztás a következőn keresztül:

ComputeTarget Osztály

Konstruktor

Paraméterek

Megjegyzések

Metódusok

attach

Paraméterek

Válaszok

Kivételek

Megjegyzések

create

Paraméterek

Válaszok

Kivételek

Megjegyzések

delete

Kivételek

Megjegyzések

deserialize

Paraméterek

Válaszok

Kivételek

Megjegyzések

detach

Kivételek

get_status

Válaszok

Kivételek

Megjegyzések

list

Paraméterek

Válaszok

Kivételek

refresh_state

Kivételek

serialize

Válaszok

Kivételek

wait_for_completion

Paraméterek

Kivételek

Visszajelzés

További források