ComputeTarget Třída

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

workspace

Workspace

Vyžadováno

Objekt pracovního prostoru obsahující objekt Compute, který se má načíst.

name

str

Vyžadováno

Název objektu Compute, který se má načíst.

workspace

Workspace

Vyžadováno

Objekt pracovního prostoru obsahující objekt Compute, který se má načíst.

name

str

Vyžadováno

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

workspace

Workspace

Vyžadováno

Objekt pracovního prostoru, ke kterým chcete připojit objekt Compute.

name

str

Vyžadováno

Název, který chcete přidružit k objektu Compute.

attach_configuration

ComputeTargetAttachConfiguration

Vyžadováno

Objekt ComputeTargetAttachConfiguration, který se používá k určení typu objektu Compute, který se má připojit, a jeho konfiguraci.

Návraty

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

Návratový typ

ComputeTarget

Výjimky

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

workspace

Workspace

Vyžadováno

Objekt pracovního prostoru, ve které chcete vytvořit objekt Compute.

name

str

Vyžadováno

Název, který chcete přidružit k objektu Compute.

provisioning_configuration

ComputeTargetProvisioningConfiguration

Vyžadováno

Objekt ComputeTargetProvisioningConfiguration, který se používá k určení typu objektu Compute, který se má zřídit, a jeho konfiguraci.

Návraty

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

Návratový typ

ComputeTarget

Výjimky

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

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

workspace

Workspace

Vyžadováno

Objekt pracovního prostoru, ke které je objekt Compute přidružený.

object_dict

dict

Vyžadováno

Objekt JSON, který se má převést na objekt Compute.

Návraty

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

Návratový typ

ComputeTarget

Výjimky

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

ComputeTargetException

get_status

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

get_status()

Návraty

Aktuální provisioning_statehodnota .

Návratový typ

str

Výjimky

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

workspace

Workspace

Vyžadováno

Objekt pracovního prostoru obsahující objekty, které se mají zobrazit.

Návraty

Seznam cílových výpočetních prostředků v pracovním prostoru

Návratový typ

list[ComputeTarget]

Výjimky

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

ComputeTargetException

serialize

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

abstract serialize()

Návraty

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

Návratový typ

dict

Výjimky

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

show_output

bool

výchozí hodnota: False

Určuje, zda se má poskytovat podrobnější výstup.

is_delete_operation

bool

výchozí hodnota: False

Určuje, zda je operace určena k odstranění.

Výjimky

ComputeTargetException