ComputeTarget Třída

Reference

Abstraktní nadřazená třída pro všechny výpočetní cíle spravované službou Azure Machine Learning

Cílový výpočetní objekt je určený výpočetní prostředek nebo prostředí, ve kterém spouštíte trénovací skript nebo hostujete nasazení služby. Toto umístění může být váš místní počítač nebo cloudový výpočetní prostředek. Další informace najdete v tématu Co jsou výpočetní cíle ve službě Azure Machine Learning?

Třída ComputeTarget – konstruktor.

Načtěte cloudovou reprezentaci výpočetního objektu přidruženého k poskytnutému pracovnímu prostoru. Vrátí instanci podřízené třídy odpovídající konkrétnímu typu načteného objektu Compute.

Dědičnost: ABC

ComputeTarget

Konstruktor

ComputeTarget(workspace, name)

Parametry

Name	Description
workspace Vyžadováno	Workspace Objekt pracovního prostoru obsahující objekt Compute, který se má načíst.
name Vyžadováno	str Název objektu Compute, který se má načíst.
workspace Vyžadováno	Workspace Objekt pracovního prostoru obsahující objekt Compute, který se má načíst.
name Vyžadováno	str Název objektu Compute, který se má načíst.

Poznámky

Pomocí konstruktoru ComputeTarget načtěte cloudovou reprezentaci objektu Compute přidruženého k poskytnutému pracovnímu prostoru. Konstruktor vrátí instanci podřízené třídy odpovídající konkrétnímu typu načteného objektu Compute. Pokud se objekt Compute nenajde, vyvolá se ComputeTargetException objekt .

Metody

attach	Připojte objekt Compute k pracovnímu prostoru pomocí zadaného názvu a informací o konfiguraci.
create	Zřiďte výpočetní objekt zadáním typu výpočetního objektu a související konfigurace. Tato metoda místo připojení existujícího cíle vytvoří nový cílový výpočetní objekt.
delete	Odeberte objekt Compute z jeho přidruženého pracovního prostoru. Tato abstraktní metoda je implementována podřízenými třídami .ComputeTarget
deserialize	Převede objekt JSON na objekt Compute.
detach	Odpojte objekt Compute od přidruženého pracovního prostoru. Tato abstraktní metoda je implementována podřízenými třídami .ComputeTarget Základní cloudové objekty se neodstraní, odeberou se jenom jejich přidružení.
get_status	Načtěte aktuální stav zřizování objektu Compute.
list	Vypíše všechny objekty ComputeTarget v rámci pracovního prostoru. Vrátí seznam instancí podřízených objektů odpovídajících konkrétnímu typu Compute. Objekty jsou podřízené objektu ComputeTarget.
refresh_state	Proveďte místní aktualizaci vlastností objektu. Aktualizujte vlastnosti na základě aktuálního stavu odpovídajícího cloudového objektu. To je užitečné pro ruční dotazování stavu výpočetních prostředků. Tato abstraktní metoda je implementována podřízenými třídami .ComputeTarget
serialize	Převeďte tento objekt Compute na serializovaný slovník JSON.
wait_for_completion	Počkejte na dokončení aktuální operace zřizování v clusteru. Tato metoda vrátí, ComputeTargetException pokud dojde k problému s dotazováním výpočetního objektu.

attach

Připojte objekt Compute k pracovnímu prostoru pomocí zadaného názvu a informací o konfiguraci.

static attach(workspace, name, attach_configuration)

Parametry

Name	Description
workspace Vyžadováno	Workspace Objekt pracovního prostoru, ke kterým chcete připojit objekt Compute.
name Vyžadováno	str Název, který chcete přidružit k objektu Compute.
attach_configuration Vyžadováno	ComputeTargetAttachConfiguration Objekt ComputeTargetAttachConfiguration, který se používá k určení typu objektu Compute, který se má připojit, a jeho konfiguraci.

Návraty

Typ	Description
ComputeTarget	Instance podřízeného objektu ComputeTarget odpovídající typu připojeného objektu.

Výjimky

Typ	Description
ComputeTargetException

Poznámky

Typ objektu, který se má předat parametru attach_configurationComputeTargetAttachConfiguration, je objekt vytvořený pomocí attach_configuration funkce v libovolné z podřízených tříd .ComputeTarget

Následující příklad ukazuje, jak připojit účet ADLA k pracovnímu prostoru pomocí attach_configuration metody AdlaCompute.


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

Úplná ukázka je k dispozici od 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

Zřiďte výpočetní objekt zadáním typu výpočetního objektu a související konfigurace.

Tato metoda místo připojení existujícího cíle vytvoří nový cílový výpočetní objekt.

static create(workspace, name, provisioning_configuration)

Parametry

Name	Description
workspace Vyžadováno	Workspace Objekt pracovního prostoru, ve které chcete vytvořit objekt Compute.
name Vyžadováno	str Název, který chcete přidružit k objektu Compute.
provisioning_configuration Vyžadováno	ComputeTargetProvisioningConfiguration Objekt ComputeTargetProvisioningConfiguration, který se používá k určení typu objektu Compute, který se má zřídit, a jeho konfiguraci.

Návraty

Typ	Description
ComputeTarget	Instance podřízeného objektu ComputeTarget odpovídající typu zřízeného objektu.

Výjimky

Typ	Description
ComputeTargetException

Poznámky

Typ zřízeného objektu je určen poskytnutou konfigurací zřizování.

V následujícím příkladu se vytvoří trvalý cílový výpočetní objekt zřízený společností AmlCompute . Parametr provisioning_configuration v tomto příkladu je typu 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)

Úplná ukázka je k dispozici od https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb

delete

Odeberte objekt Compute z jeho přidruženého pracovního prostoru.

Tato abstraktní metoda je implementována podřízenými třídami .ComputeTarget

abstract delete()

Výjimky

Typ	Description
ComputeTargetException

Poznámky

Pokud byl tento objekt vytvořen prostřednictvím služby Azure Machine Learning, odstraní se také odpovídající cloudové objekty. Pokud byl tento objekt vytvořen externě a pouze připojen k pracovnímu prostoru, tato metoda vyvolá výjimku a nic se nezmění.

deserialize

Převede objekt JSON na objekt Compute.

abstract static deserialize(workspace, object_dict)

Parametry

Name	Description
workspace Vyžadováno	Workspace Objekt pracovního prostoru, ke které je objekt Compute přidružený.
object_dict Vyžadováno	dict Objekt JSON, který se má převést na objekt Compute.

Návraty

Typ	Description
ComputeTarget	Výpočetní reprezentace zadaného objektu JSON.

Výjimky

Typ	Description
ComputeTargetException

Poznámky

Vyvolá, ComputeTargetException pokud zadaný pracovní prostor není pracovním prostorem, ke který je přidružen compute.

detach

Odpojte objekt Compute od přidruženého pracovního prostoru.

Tato abstraktní metoda je implementována podřízenými třídami .ComputeTarget Základní cloudové objekty se neodstraní, odeberou se jenom jejich přidružení.

abstract detach()

Výjimky

Typ	Description
ComputeTargetException

get_status

Načtěte aktuální stav zřizování objektu Compute.

get_status()

Návraty

Typ	Description
str	Aktuální `provisioning_state`hodnota .

Výjimky

Typ	Description
ComputeTargetException

Poznámky

Vrácené hodnoty jsou uvedené v referenčních informacích k rozhraní Azure REST API pro ProvisioningState.

list

Vypíše všechny objekty ComputeTarget v rámci pracovního prostoru.

Vrátí seznam instancí podřízených objektů odpovídajících konkrétnímu typu Compute. Objekty jsou podřízené objektu ComputeTarget.

static list(workspace)

Parametry

Name	Description
workspace Vyžadováno	Workspace Objekt pracovního prostoru obsahující objekty, které se mají zobrazit.

Návraty

Typ	Description
list[ComputeTarget]	Seznam cílových výpočetních prostředků v pracovním prostoru

Výjimky

Typ	Description
ComputeTargetException

refresh_state

Proveďte místní aktualizaci vlastností objektu.

Aktualizujte vlastnosti na základě aktuálního stavu odpovídajícího cloudového objektu. To je užitečné pro ruční dotazování stavu výpočetních prostředků.

Tato abstraktní metoda je implementována podřízenými třídami .ComputeTarget

abstract refresh_state()

Výjimky

Typ	Description
ComputeTargetException

serialize

Převeďte tento objekt Compute na serializovaný slovník JSON.

abstract serialize()

Návraty

Typ	Description
dict	Reprezentace JSON tohoto výpočetního objektu.

Výjimky

Typ	Description
ComputeTargetException

wait_for_completion

Počkejte na dokončení aktuální operace zřizování v clusteru.

Tato metoda vrátí, ComputeTargetException pokud dojde k problému s dotazováním výpočetního objektu.

wait_for_completion(show_output=False, is_delete_operation=False)

Parametry

Name	Description
show_output	bool Určuje, zda se má poskytovat podrobnější výstup. Default value: False
is_delete_operation	bool Určuje, zda je operace určena k odstranění. Default value: False

Výjimky

Typ	Description
ComputeTargetException

Sdílet prostřednictvím

ComputeTarget Třída

Konstruktor

Parametry

Poznámky

Metody

attach

Parametry

Návraty

Výjimky

Poznámky

create

Parametry

Návraty

Výjimky

Poznámky

delete

Výjimky

Poznámky

deserialize

Parametry

Návraty

Výjimky

Poznámky

detach

Výjimky

get_status

Návraty

Výjimky

Poznámky

list

Parametry

Návraty

Výjimky

refresh_state

Výjimky

serialize

Návraty

Výjimky

wait_for_completion

Parametry

Výjimky

Váš názor

Další materiály