ComputeTarget Klass

Abstrakt överordnad klass för alla beräkningsmål som hanteras av Azure Machine Learning.

Ett beräkningsmål är en utsedd beräkningsresurs/miljö där du kör träningsskriptet eller är värd för tjänstdistributionen. Den här platsen kan vara din lokala dator eller en molnbaserad beräkningsresurs. Mer information finns i Vad är beräkningsmål i Azure Machine Learning?

ComputeTarget-konstruktor för klass.

Hämta en molnrepresentation av ett Compute-objekt som är associerat med den angivna arbetsytan. Returnerar en instans av en underordnad klass som motsvarar den specifika typen av det hämtade beräkningsobjektet.

Arv
ComputeTarget

Konstruktor

ComputeTarget(workspace, name)

Parametrar

Name Description
workspace
Obligatorisk

Arbetsyteobjektet som innehåller beräkningsobjektet som ska hämtas.

name
Obligatorisk
str

Namnet på beräkningsobjektet som ska hämtas.

workspace
Obligatorisk

Arbetsyteobjektet som innehåller beräkningsobjektet som ska hämtas.

name
Obligatorisk
str

Namnet på det Compute-objekt som ska hämtas.

Kommentarer

Använd ComputeTarget-konstruktorn för att hämta molnrepresentationen av ett Compute-objekt som är associerat med den angivna arbetsytan. Konstruktorn returnerar en instans av en underordnad klass som motsvarar den specifika typen av det hämtade Compute-objektet. Om compute-objektet inte hittas utlöses ett ComputeTargetException .

Metoder

attach

Koppla ett Compute-objekt till en arbetsyta med det angivna namnet och konfigurationsinformationen.

create

Etablera ett Compute-objekt genom att ange en beräkningstyp och relaterad konfiguration.

Den här metoden skapar ett nytt beräkningsmål i stället för att koppla ett befintligt.

delete

Ta bort Compute-objektet från dess associerade arbetsyta.

Den här abstrakta metoden implementeras av underordnade klasser i ComputeTarget.

deserialize

Konvertera ett JSON-objekt till ett Compute-objekt.

detach

Koppla från Compute-objektet från dess associerade arbetsyta.

Den här abstrakta metoden implementeras av underordnade klasser i ComputeTarget. Underliggande molnobjekt tas inte bort, endast deras associationer tas bort.

get_status

Hämta det aktuella etableringstillståndet för Compute-objektet.

list

Visa en lista över alla ComputeTarget-objekt på arbetsytan.

Returnera en lista över instansierade underordnade objekt som motsvarar den specifika typen av beräkning. Objekt är underordnade ComputeTargettill .

refresh_state

Utför en uppdatering på plats av objektets egenskaper.

Uppdatera egenskaper baserat på det aktuella tillståndet för motsvarande molnobjekt. Detta är användbart för manuell avsökning av beräkningstillstånd.

Den här abstrakta metoden implementeras av underordnade klasser i ComputeTarget.

serialize

Konvertera det här Compute-objektet till en JSON-serialiserad ordlista.

wait_for_completion

Vänta tills den aktuella etableringsåtgärden har slutförts i klustret.

Den här metoden returnerar en ComputeTargetException om det finns ett problem med att avsöka beräkningsobjektet.

attach

Koppla ett Compute-objekt till en arbetsyta med det angivna namnet och konfigurationsinformationen.

static attach(workspace, name, attach_configuration)

Parametrar

Name Description
workspace
Obligatorisk

Det arbetsyteobjekt som beräkningsobjektet ska kopplas till.

name
Obligatorisk
str

Namnet som ska associeras med Compute-objektet.

attach_configuration
Obligatorisk

Ett ComputeTargetAttachConfiguration-objekt som används för att fastställa vilken typ av Compute-objekt som ska kopplas och hur det ska konfigureras.

Returer

Typ Description

En instans av ett underordnat ComputeTarget som motsvarar den typ av objekt som är kopplat.

Undantag

Typ Description

Kommentarer

Den typ av objekt som ska skickas till parametern attach_configuration är ett ComputeTargetAttachConfiguration objekt som skapats med funktionen attach_configuration på någon av de underordnade klasserna i ComputeTarget.

I följande exempel visas hur du kopplar ett ADLA-konto till en arbetsyta med hjälp attach_configuration av metoden 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))

Fullständigt exempel är tillgängligt från 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

Etablera ett Compute-objekt genom att ange en beräkningstyp och relaterad konfiguration.

Den här metoden skapar ett nytt beräkningsmål i stället för att koppla ett befintligt.

static create(workspace, name, provisioning_configuration)

Parametrar

Name Description
workspace
Obligatorisk

Det arbetsyteobjekt som beräkningsobjektet ska skapas under.

name
Obligatorisk
str

Namnet som ska associeras med Compute-objektet.

provisioning_configuration
Obligatorisk

Ett ComputeTargetProvisioningConfiguration-objekt som används för att fastställa vilken typ av Compute-objekt som ska etableras och hur det ska konfigureras.

Returer

Typ Description

En instans av ett underordnat ComputeTarget som motsvarar den typ av objekt som etablerats.

Undantag

Typ Description

Kommentarer

Den typ av objekt som etableras bestäms av den tillhandahållna etableringskonfigurationen.

I följande exempel skapas ett beständigt beräkningsmål som etablerats av AmlCompute . Parametern provisioning_configuration i det här exemplet är av typen 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)

Fullständigt exempel är tillgängligt från https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb

delete

Ta bort Compute-objektet från dess associerade arbetsyta.

Den här abstrakta metoden implementeras av underordnade klasser i ComputeTarget.

abstract delete()

Undantag

Typ Description

Kommentarer

Om det här objektet har skapats via Azure Machine Learning tas även motsvarande molnbaserade objekt bort. Om det här objektet har skapats externt och endast kopplats till arbetsytan genererar den här metoden ett undantag och ingenting ändras.

deserialize

Konvertera ett JSON-objekt till ett Compute-objekt.

abstract static deserialize(workspace, object_dict)

Parametrar

Name Description
workspace
Obligatorisk

Arbetsyteobjektet som Compute-objektet är associerat med.

object_dict
Obligatorisk

Ett JSON-objekt som ska konverteras till ett Compute-objekt.

Returer

Typ Description

Beräkningsrepresentationen av det angivna JSON-objektet.

Undantag

Typ Description

Kommentarer

Genererar en ComputeTargetException om den angivna arbetsytan inte är den arbetsyta som Compute är associerad med.

detach

Koppla från Compute-objektet från dess associerade arbetsyta.

Den här abstrakta metoden implementeras av underordnade klasser i ComputeTarget. Underliggande molnobjekt tas inte bort, endast deras associationer tas bort.

abstract detach()

Undantag

Typ Description

get_status

Hämta det aktuella etableringstillståndet för Compute-objektet.

get_status()

Returer

Typ Description
str

provisioning_stateAktuell .

Undantag

Typ Description

Kommentarer

Värden som returneras visas i Azure REST API-referensen för ProvisioningState.

list

Visa en lista över alla ComputeTarget-objekt på arbetsytan.

Returnera en lista över instansierade underordnade objekt som motsvarar den specifika typen av beräkning. Objekt är underordnade ComputeTargettill .

static list(workspace)

Parametrar

Name Description
workspace
Obligatorisk

Arbetsyteobjektet som innehåller objekten som ska listas.

Returer

Typ Description

Lista över beräkningsmål på arbetsytan.

Undantag

Typ Description

refresh_state

Utför en uppdatering på plats av objektets egenskaper.

Uppdatera egenskaper baserat på det aktuella tillståndet för motsvarande molnobjekt. Detta är användbart för manuell avsökning av beräkningstillstånd.

Den här abstrakta metoden implementeras av underordnade klasser i ComputeTarget.

abstract refresh_state()

Undantag

Typ Description

serialize

Konvertera det här Compute-objektet till en JSON-serialiserad ordlista.

abstract serialize()

Returer

Typ Description

JSON-representationen av det här Compute-objektet.

Undantag

Typ Description

wait_for_completion

Vänta tills den aktuella etableringsåtgärden har slutförts i klustret.

Den här metoden returnerar en ComputeTargetException om det finns ett problem med att avsöka beräkningsobjektet.

wait_for_completion(show_output=False, is_delete_operation=False)

Parametrar

Name Description
show_output

Anger om du vill ge mer utförliga utdata.

Standardvärde: False
is_delete_operation

Anger om åtgärden är avsedd för borttagning.

Standardvärde: False

Undantag

Typ Description