ComputeTarget Klass

Referens

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

Ett beräkningsmål är en avsedd 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?

Class ComputeTarget-konstruktor.

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: ABC

ComputeTarget

Konstruktor

ComputeTarget(workspace, name)

Parametrar

Name	Description
workspace Obligatorisk	Workspace Arbetsyteobjektet som innehåller compute-objektet som ska hämtas.
name Obligatorisk	str Namnet på beräkningsobjektet som ska hämtas.
workspace Obligatorisk	Workspace Arbetsyteobjektet som innehåller compute-objektet 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 beräkningsobjektet inte hittas utlöses ett ComputeTargetException .

Metoder

attach	Koppla ett Beräkningsobjekt till en arbetsyta med det angivna namnet och konfigurationsinformationen.
create	Etablera ett Beräkningsobjekt 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 Beräkningsobjekt.
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 i 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 beräkningsobjektet till en serialiserad JSON-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 Beräkningsobjekt till en arbetsyta med det angivna namnet och konfigurationsinformationen.

static attach(workspace, name, attach_configuration)

Parametrar

Name	Description
workspace Obligatorisk	Workspace Det arbetsyteobjekt som beräkningsobjektet ska kopplas till.
name Obligatorisk	str Namnet som ska associeras med Compute-objektet.
attach_configuration Obligatorisk	ComputeTargetAttachConfiguration Ett ComputeTargetAttachConfiguration-objekt som används för att fastställa vilken typ av Compute-objekt som ska bifogas och hur det ska konfigureras.

Returer

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

Undantag

Typ	Description
ComputeTargetException

Kommentarer

Den typ av objekt som ska skickas till parametern attach_configuration är ett ComputeTargetAttachConfiguration objekt som skapats med hjälp attach_configuration av funktionen 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 Beräkningsobjekt 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	Workspace Det arbetsyteobjekt som beräkningsobjektet ska skapas under.
name Obligatorisk	str Namnet som ska associeras med Compute-objektet.
provisioning_configuration Obligatorisk	ComputeTargetProvisioningConfiguration 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
ComputeTarget	En instans av en underordnad ComputeTarget som motsvarar den typ av objekt som har etablerats.

Undantag

Typ	Description
ComputeTargetException

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
ComputeTargetException

Kommentarer

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

deserialize

Konvertera ett JSON-objekt till ett Beräkningsobjekt.

abstract static deserialize(workspace, object_dict)

Parametrar

Name	Description
workspace Obligatorisk	Workspace Arbetsyteobjektet som Compute-objektet är associerat med.
object_dict Obligatorisk	dict Ett JSON-objekt som ska konverteras till ett Beräkningsobjekt.

Returer

Typ	Description
ComputeTarget	Beräkningsrepresentationen av det angivna JSON-objektet.

Undantag

Typ	Description
ComputeTargetException

Kommentarer

Genererar en ComputeTargetException om den angivna arbetsytan inte är den arbetsyta som beräkning ä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
ComputeTargetException

get_status

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

get_status()

Returer

Typ	Description
str	`provisioning_state`Aktuell .

Undantag

Typ	Description
ComputeTargetException

Kommentarer

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

list

Visa en lista över alla ComputeTarget-objekt i 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	Workspace Arbetsyteobjektet som innehåller de objekt som ska listas.

Returer

Typ	Description
list[ComputeTarget]	Lista över beräkningsmål på arbetsytan.

Undantag

Typ	Description
ComputeTargetException

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
ComputeTargetException

serialize

Konvertera det här beräkningsobjektet till en serialiserad JSON-ordlista.

abstract serialize()

Returer

Typ	Description
dict	JSON-representationen av det här beräkningsobjektet.

Undantag

Typ	Description
ComputeTargetException

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	bool Anger om du vill ge mer utförliga utdata. Standardvärde: False
is_delete_operation	bool Anger om åtgärden är avsedd för borttagning. Standardvärde: False

Undantag

Typ	Description
ComputeTargetException

Dela via

ComputeTarget Klass

Konstruktor

Parametrar

Kommentarer

Metoder

attach

Parametrar

Returer

Undantag

Kommentarer

create

Parametrar

Returer

Undantag

Kommentarer

delete

Undantag

Kommentarer

deserialize

Parametrar

Returer

Undantag

Kommentarer

detach

Undantag

get_status

Returer

Undantag

Kommentarer

list

Parametrar

Returer

Undantag

refresh_state

Undantag

serialize

Returer

Undantag

wait_for_completion

Parametrar

Undantag

Feedback

Ytterligare resurser