ComputeTarget Klasa

Abstrakcyjna klasa nadrzędna dla wszystkich obiektów docelowych obliczeń zarządzanych przez Azure Machine Learning.

Obiekt docelowy obliczeń to wyznaczono zasób obliczeniowy/środowisko, w którym jest uruchamiany skrypt szkoleniowy lub hostowanie wdrożenia usługi. Ta lokalizacja może być maszyną lokalną lub zasobem obliczeniowym opartym na chmurze. Aby uzyskać więcej informacji, zobacz co to są cele obliczeniowe w Azure Machine Learning?

Dziedziczenie
abc.ABC
ComputeTarget

Konstruktor

ComputeTarget(workspace, name)

Parametry

workspace
Workspace

Obiekt obszaru roboczego zawierający obiekt obliczeniowy do pobrania.

name
<xref:str>

Nazwa obiektu obliczeniowego do pobrania.

Uwagi

Użyj konstruktora ComputeTarget, aby pobrać reprezentację w chmurze obiektu obliczeniowego skojarzonego z udostępnionym obszarem roboczym. Konstruktor zwraca wystąpienie klasy podrzędnej odpowiadającej określonemu typowi pobranego obiektu obliczeniowego. Jeśli obiekt COMPUTE nie zostanie znaleziony, ComputeTargetException zostanie zgłoszony.

Metody

attach

Dołącz obiekt obliczeniowy do obszaru roboczego przy użyciu określonej nazwy i informacji o konfiguracji.

create

Zainicjuj obsługę obiektu obliczeniowego, określając typ obliczeń i powiązaną konfigurację.

Ta metoda tworzy nowy obiekt docelowy obliczeń zamiast dołączać istniejący.

delete

Usuń obiekt COMPUTE ze skojarzonego z nim obszaru roboczego.

Ta metoda abstrakcyjna jest implementowana przez klasy podrzędne ComputeTarget .

deserialize

Przekonwertuj obiekt JSON na obiekt obliczeniowy.

detach

Odłączanie obiektu COMPUTE ze skojarzonego z nim obszaru roboczego.

Ta metoda abstrakcyjna jest implementowana przez klasy podrzędne ComputeTarget . Obiekty w chmurze źródłowej nie są usuwane, tylko ich skojarzenia są usuwane.

get_status

Pobierz bieżący stan aprowizacji obiektu COMPUTE.

list

Wyświetl listę wszystkich obiektów ComputeTarget w obszarze roboczym.

Zwraca listę obiektów podrzędnych, które odpowiadają określonemu typowi obliczeń. Obiekty są elementami podrzędnymi ComputeTarget .

refresh_state

Wykonaj aktualizację w miejscu właściwości obiektu.

Zaktualizuj właściwości na podstawie bieżącego stanu odpowiedniego obiektu w chmurze. Jest to przydatne do ręcznego sondowania stanu obliczeń.

Ta metoda abstrakcyjna jest implementowana przez klasy podrzędne ComputeTarget .

serialize

Przekonwertuj ten obiekt obliczeniowy do słownika serializowanego JSON.

wait_for_completion

Poczekaj na zakończenie bieżącej operacji aprowizacji w klastrze.

Ta metoda zwraca wartość, ComputeTargetException Jeśli wystąpił problem podczas sondowania obiektu COMPUTE.

attach

Dołącz obiekt obliczeniowy do obszaru roboczego przy użyciu określonej nazwy i informacji o konfiguracji.

attach(workspace, name, attach_configuration)

Parametry

workspace
Workspace

Obiekt obszaru roboczego, do którego ma zostać dołączony obiekt obliczeniowy.

name
<xref:str>

Nazwa, która ma zostać skojarzona z obiektem COMPUTE.

attach_configuration
ComputeTargetAttachConfiguration

Obiekt ComputeTargetAttachConfiguration, który jest używany do określenia typu obiektu obliczeniowego do dołączenia i sposobu jego konfiguracji.

Zwraca

Wystąpienie elementu podrzędnego ComputeTarget odpowiadające typowi dołączonego obiektu.

Typ zwracany

Wyjątki

Uwagi

Typem obiektu do przekazania do parametru attach_configuration jest ComputeTargetAttachConfiguration Obiekt utworzony przy użyciu attach_configuration funkcji dla dowolnej klasy podrzędnej ComputeTarget .

Poniższy przykład przedstawia sposób dołączania konta ADLA do obszaru roboczego przy użyciu 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))

Pełny przykład jest dostępny z 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

Zainicjuj obsługę obiektu obliczeniowego, określając typ obliczeń i powiązaną konfigurację.

Ta metoda tworzy nowy obiekt docelowy obliczeń zamiast dołączać istniejący.

create(workspace, name, provisioning_configuration)

Parametry

workspace
Workspace

Obiekt obszaru roboczego, w którym ma zostać utworzony obiekt obliczeniowy.

name
<xref:str>

Nazwa, która ma zostać skojarzona z obiektem COMPUTE.

provisioning_configuration
ComputeTargetProvisioningConfiguration

Obiekt ComputeTargetProvisioningConfiguration, który jest używany do określenia typu obiektu obliczeniowego do aprowizacji i sposobu jego konfiguracji.

Zwraca

Wystąpienie elementu podrzędnego ComputeTarget odpowiadające typowi obiektu, który został zainicjowany.

Typ zwracany

Wyjątki

Uwagi

Typ obsługiwanego obiektu jest określany na podstawie podanej konfiguracji aprowizacji.

W poniższym przykładzie tworzony jest trwały element docelowy obliczeń inicjowany przez program AmlCompute . provisioning_configurationParametr w tym przykładzie jest 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)

Pełny przykład jest dostępny z https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb

delete

Usuń obiekt COMPUTE ze skojarzonego z nim obszaru roboczego.

Ta metoda abstrakcyjna jest implementowana przez klasy podrzędne ComputeTarget .

delete()

Wyjątki

Uwagi

Jeśli ten obiekt został utworzony za pośrednictwem Azure Machine Learning, odpowiednie obiekty oparte na chmurze również zostaną usunięte. Jeśli ten obiekt został utworzony zewnętrznie i tylko dołączony do obszaru roboczego, ta metoda zgłasza wyjątek, a niczego nie zmieniono.

deserialize

Przekonwertuj obiekt JSON na obiekt obliczeniowy.

deserialize(workspace, object_dict)

Parametry

workspace
Workspace

Obiekt obszaru roboczego, z którym jest skojarzony obiekt obliczeniowy.

object_dict
<xref:dict>

Obiekt JSON do przekonwertowania na obiekt obliczeniowy.

Zwraca

Reprezentacja obliczeń dla podanego obiektu JSON.

Typ zwracany

Wyjątki

Uwagi

Podnosi wartość, ComputeTargetException Jeśli udostępniony obszar roboczy nie jest obszarem roboczym, z którym jest skojarzone obliczenie.

detach

Odłączanie obiektu COMPUTE ze skojarzonego z nim obszaru roboczego.

Ta metoda abstrakcyjna jest implementowana przez klasy podrzędne ComputeTarget . Obiekty w chmurze źródłowej nie są usuwane, tylko ich skojarzenia są usuwane.

detach()

Wyjątki

get_status

Pobierz bieżący stan aprowizacji obiektu COMPUTE.

get_status()

Zwraca

Bieżąca klasa provisioning_state.

Typ zwracany

<xref:str>

Wyjątki

Uwagi

Zwrócone wartości są wymienione w dokumentacji interfejsu API REST platformy Azure dla ProvisioningState.

list

Wyświetl listę wszystkich obiektów ComputeTarget w obszarze roboczym.

Zwraca listę obiektów podrzędnych, które odpowiadają określonemu typowi obliczeń. Obiekty są elementami podrzędnymi ComputeTarget .

list(workspace)

Parametry

workspace
Workspace

Obiekt obszaru roboczego zawierający obiekty do wyświetlenia.

Zwraca

Lista obiektów docelowych obliczeń w obszarze roboczym.

Typ zwracany

Wyjątki

refresh_state

Wykonaj aktualizację w miejscu właściwości obiektu.

Zaktualizuj właściwości na podstawie bieżącego stanu odpowiedniego obiektu w chmurze. Jest to przydatne do ręcznego sondowania stanu obliczeń.

Ta metoda abstrakcyjna jest implementowana przez klasy podrzędne ComputeTarget .

refresh_state()

Wyjątki

serialize

Przekonwertuj ten obiekt obliczeniowy do słownika serializowanego JSON.

serialize()

Zwraca

Reprezentacja JSON tego obiektu obliczeniowego.

Typ zwracany

<xref:dict>

Wyjątki

wait_for_completion

Poczekaj na zakończenie bieżącej operacji aprowizacji w klastrze.

Ta metoda zwraca wartość, ComputeTargetException Jeśli wystąpił problem podczas sondowania obiektu COMPUTE.

wait_for_completion(show_output=False, is_delete_operation=False)

Parametry

show_output
<xref:bool>
wartość domyślna: False

Wskazuje, czy mają być podane szczegółowe informacje wyjściowe.

is_delete_operation
<xref:bool>
wartość domyślna: False

Wskazuje, czy operacja jest przeznaczona do usunięcia.

Wyjątki