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

ABC

ComputeTarget

Konstruktor

ComputeTarget(workspace, name)

Parametrar

workspace

Workspace

Obligatorisk

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

name

str

Obligatorisk

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

workspace

Workspace

Obligatorisk

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

name

str

Obligatorisk

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

workspace

Workspace

Obligatorisk

Det arbetsyteobjekt som beräkningsobjektet ska kopplas till.

name

str

Obligatorisk

Namnet som ska associeras med Compute-objektet.

attach_configuration

ComputeTargetAttachConfiguration

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

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

Returtyp

ComputeTarget

Undantag

ComputeTargetException

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

workspace

Workspace

Obligatorisk

Det arbetsyteobjekt som beräkningsobjektet ska skapas under.

name

str

Obligatorisk

Namnet som ska associeras med Compute-objektet.

provisioning_configuration

ComputeTargetProvisioningConfiguration

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

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

Returtyp

ComputeTarget

Undantag

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

ComputeTargetException

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

workspace

Workspace

Obligatorisk

Arbetsyteobjektet som Compute-objektet är associerat med.

object_dict

dict

Obligatorisk

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

Returer

Beräkningsrepresentationen av det angivna JSON-objektet.

Returtyp

ComputeTarget

Undantag

ComputeTargetException

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

ComputeTargetException

get_status

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

get_status()

Returer

provisioning_stateAktuell .

Returtyp

str

Undantag

ComputeTargetException

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

workspace

Workspace

Obligatorisk

Arbetsyteobjektet som innehåller objekten som ska listas.

Returer

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

Returtyp

list[ComputeTarget]

Undantag

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

ComputeTargetException

serialize

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

abstract serialize()

Returer

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

Returtyp

dict

Undantag

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

show_output

bool

standardvärde: False

Anger om du vill ge mer utförliga utdata.

is_delete_operation

bool

standardvärde: False

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

Undantag

ComputeTargetException