ComputeTarget Třída

Abstraktní nadřazená třída pro všechny cílové výpočetní objekty 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 cílové výpočetní objekty ve službě Azure Machine Learning?

Třída ComputeTarget konstruktor.

Načtení cloudové reprezentace 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í určitému typu načteného výpočetního objektu.

Konstruktor

ComputeTarget(workspace, name)

Parametry

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

Poznámky

Pomocí konstruktoru ComputeTarget načtěte cloudovou reprezentaci výpočetního objektu přidruženého k poskytnutému pracovnímu prostoru. Konstruktor vrátí instanci podřízené třídy odpovídající určitému typu načteného výpočetního objektu. Pokud výpočetní objekt nebyl nalezen, je vyvolána ComputeTargetException .

Metody

attach	Připojte objekt Compute k pracovnímu prostoru pomocí zadaného názvu a konfiguračních informací.
create	Zřízení výpočetního objektu zadáním typu výpočetního objektu a související konfigurace Tato metoda místo připojení existujícího objektu vytvoří nový cílový výpočetní objekt.
delete	Odeberte objekt Compute z 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 výpočetní objekt.
detach	Odpojte výpočetní objekt 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 určitému typu Compute. Objekty jsou podřízené objekty 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í výpočetního stavu. Tato abstraktní metoda je implementována podřízenými třídami ComputeTarget.
serialize	Převeďte tento výpočetní objekt 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 chybu, pokud dojde k potížím s dotazováním výpočetního objektu.

attach

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

static attach(workspace, name, attach_configuration)

Parametry

Name	Description
workspace Vyžadováno	Workspace Objekt pracovního prostoru pro připojení výpočetního objektu.
name Vyžadováno	str Název, který chcete přidružit k výpočetnímu objektu.
attach_configuration Vyžadováno	ComputeTargetAttachConfiguration Objekt ComputeTargetAttachConfiguration, který se používá k určení typu výpočetního objektu, který se má připojit, a jak ho nakonfigurovat.

Návraty

Typ	Description
ComputeTarget	Instance podřízené 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 na libovolné podřízené třídy ComputeTargettřídy .

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řízení výpočetního objektu zadáním typu výpočetního objektu a související konfigurace

Tato metoda místo připojení existujícího objektu 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 pro vytvoření výpočetního objektu v části.
name Vyžadováno	str Název, který chcete přidružit k výpočetnímu objektu.
provisioning_configuration Vyžadováno	ComputeTargetProvisioningConfiguration Objekt ComputeTargetProvisioningConfiguration, který se používá k určení typu výpočetního objektu, který se má zřídit a jak ho nakonfigurovat.

Návraty

Typ	Description
ComputeTarget	Instance podřízené 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 zadanou konfigurací zřizování.

V následujícím příkladu se vytvoří trvalý cílový výpočetní objekt zřízený službou 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 přidruženého pracovního prostoru.

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

abstract delete()

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 výpočetní objekt.

abstract static deserialize(workspace, object_dict)

Parametry

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

Návraty

Typ	Description
ComputeTarget	Reprezentace výpočetního objektu zadaného objektu JSON.

Poznámky

ComputeTargetException Vyvolá, pokud zadaný pracovní prostor není pracovním prostorem, ke kterým je přidružený výpočetní objekt.

detach

Odpojte výpočetní objekt 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()

get_status

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

get_status()

Návraty

Typ	Description
str	Aktuální provisioning_state.

Poznámky

Vrácené hodnoty jsou uvedeny 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 určitému typu Compute. Objekty jsou podřízené objekty ComputeTarget.

static list(workspace)

Parametry

Name	Description
workspace Vyžadováno	Workspace Objekt pracovního prostoru obsahující objekty k zobrazení seznamu.

Návraty

Typ	Description
list[ComputeTarget]	Seznam cílových výpočetních prostředků v rámci pracovního 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í výpočetního stavu.

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

abstract refresh_state()

serialize

Převeďte tento výpočetní objekt na serializovaný slovník JSON.

abstract serialize()

Návraty

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

wait_for_completion

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

Tato metoda vrátí ComputeTargetException chybu, pokud dojde k potížím 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, jestli chcete poskytnout podrobnější výstup. Default value: False
is_delete_operation	bool Určuje, jestli je operace určená k odstranění. Default value: False

Výjimky

Typ	Description
ComputeTargetException