Delen via


ComputeTarget Klas

Abstracte bovenliggende klasse voor alle rekendoelen die worden beheerd door Azure Machine Learning.

Een rekendoel is een aangewezen rekenresource/-omgeving waarin u uw trainingsscript uitvoert of uw service-implementatie host. Deze locatie is mogelijk uw lokale computer of een rekenresource in de cloud. Zie Wat zijn rekendoelen in Azure Machine Learning voor meer informatie?

Klasse ComputeTarget-constructor.

Haal een cloudweergave op van een Compute-object dat is gekoppeld aan de opgegeven werkruimte. Retourneert een exemplaar van een onderliggende klasse die overeenkomt met het specifieke type van het opgehaalde compute-object.

Constructor

ComputeTarget(workspace, name)

Parameters

Name Description
workspace
Vereist

Het werkruimteobject met het rekenobject dat moet worden opgehaald.

name
Vereist
str

De naam van het rekenobject dat moet worden opgehaald.

workspace
Vereist

Het werkruimteobject met het rekenobject dat moet worden opgehaald.

name
Vereist
str

De naam van het rekenobject dat moet worden opgehaald.

Opmerkingen

Gebruik de ComputeTarget-constructor om de cloudweergave op te halen van een Compute-object dat is gekoppeld aan de opgegeven werkruimte. De constructor retourneert een exemplaar van een onderliggende klasse die overeenkomt met het specifieke type van het opgehaalde Compute-object. Als het Compute-object niet wordt gevonden, wordt er een ComputeTargetException gegenereerd.

Methoden

attach

Koppel een rekenobject aan een werkruimte met behulp van de opgegeven naam en configuratiegegevens.

create

Richt een rekenobject in door een rekentype en gerelateerde configuratie op te geven.

Met deze methode maakt u een nieuw rekendoel in plaats van een bestaande te koppelen.

delete

Verwijder het Compute-object uit de bijbehorende werkruimte.

Deze abstracte methode wordt geïmplementeerd door onderliggende klassen van ComputeTarget.

deserialize

Converteer een JSON-object naar een Compute-object.

detach

Koppel het compute-object los van de bijbehorende werkruimte.

Deze abstracte methode wordt geïmplementeerd door onderliggende klassen van ComputeTarget. Onderliggende cloudobjecten worden niet verwijderd, alleen de bijbehorende koppelingen worden verwijderd.

get_status

Haal de huidige inrichtingsstatus van het compute-object op.

list

Geef alle ComputeTarget-objecten in de werkruimte weer.

Retourneert een lijst met geïnstantieerde onderliggende objecten die overeenkomen met het specifieke type Compute. Objecten zijn onderliggende elementen van ComputeTarget.

refresh_state

Voer een in-place update uit van de eigenschappen van het object.

Eigenschappen bijwerken op basis van de huidige status van het bijbehorende cloudobject. Dit is handig voor handmatige polling van de rekenstatus.

Deze abstracte methode wordt geïmplementeerd door onderliggende klassen van ComputeTarget.

serialize

Converteer dit Compute-object naar een geserialiseerde JSON-woordenlijst.

wait_for_completion

Wacht tot de huidige inrichtingsbewerking is voltooid op het cluster.

Deze methode retourneert een ComputeTargetException als er een probleem is met het peilen van het rekenobject.

attach

Koppel een rekenobject aan een werkruimte met behulp van de opgegeven naam en configuratiegegevens.

static attach(workspace, name, attach_configuration)

Parameters

Name Description
workspace
Vereist

Het werkruimteobject waaraan het Compute-object moet worden gekoppeld.

name
Vereist
str

De naam die moet worden gekoppeld aan het compute-object.

attach_configuration
Vereist

Een ComputeTargetAttachConfiguration-object dat wordt gebruikt om het type Compute-object te bepalen dat moet worden gekoppeld en hoe u dit kunt configureren.

Retouren

Type Description

Een exemplaar van een onderliggend element van ComputeTarget dat overeenkomt met het type object dat is gekoppeld.

Uitzonderingen

Type Description

Opmerkingen

Het type object dat moet worden doorgegeven aan de parameter attach_configuration is een ComputeTargetAttachConfiguration object dat is gebouwd met behulp van de attach_configuration functie op een van de onderliggende klassen van ComputeTarget.

In het volgende voorbeeld ziet u hoe u een ADLA-account aan een werkruimte koppelt met behulp van de attach_configuration methode 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))

Volledig voorbeeld is beschikbaar vanaf 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

Richt een rekenobject in door een rekentype en gerelateerde configuratie op te geven.

Met deze methode maakt u een nieuw rekendoel in plaats van een bestaande te koppelen.

static create(workspace, name, provisioning_configuration)

Parameters

Name Description
workspace
Vereist

Het werkruimteobject waaronder het rekenobject wordt gemaakt.

name
Vereist
str

De naam die moet worden gekoppeld aan het compute-object.

provisioning_configuration
Vereist

Een ComputeTargetProvisioningConfiguration-object dat wordt gebruikt om het type rekenobject te bepalen dat moet worden ingericht en hoe u dit configureert.

Retouren

Type Description

Een exemplaar van een onderliggend element van ComputeTarget dat overeenkomt met het type object dat is ingericht.

Uitzonderingen

Type Description

Opmerkingen

Het type object dat is ingericht, wordt bepaald door de inrichtingsconfiguratie die is opgegeven.

In het volgende voorbeeld wordt een permanent rekendoel gemaakt dat is AmlCompute ingericht. De provisioning_configuration parameter in dit voorbeeld is van het type 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)

Volledig voorbeeld is beschikbaar vanaf https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb

delete

Verwijder het Compute-object uit de bijbehorende werkruimte.

Deze abstracte methode wordt geïmplementeerd door onderliggende klassen van ComputeTarget.

abstract delete()

Opmerkingen

Als dit object is gemaakt via Azure Machine Learning, worden de bijbehorende cloudobjecten ook verwijderd. Als dit object extern is gemaakt en alleen is gekoppeld aan de werkruimte, genereert deze methode een uitzondering en wordt er niets gewijzigd.

deserialize

Converteer een JSON-object naar een Compute-object.

abstract static deserialize(workspace, object_dict)

Parameters

Name Description
workspace
Vereist

Het werkruimteobject waarmee het rekenobject is gekoppeld.

object_dict
Vereist

Een JSON-object dat moet worden geconverteerd naar een Compute-object.

Retouren

Type Description

De compute-weergave van het opgegeven JSON-object.

Opmerkingen

Hiermee wordt een ComputeTargetException opgegeven als de opgegeven werkruimte niet de werkruimte is waarmee compute is gekoppeld.

detach

Koppel het compute-object los van de bijbehorende werkruimte.

Deze abstracte methode wordt geïmplementeerd door onderliggende klassen van ComputeTarget. Onderliggende cloudobjecten worden niet verwijderd, alleen de bijbehorende koppelingen worden verwijderd.

abstract detach()

get_status

Haal de huidige inrichtingsstatus van het compute-object op.

get_status()

Retouren

Type Description
str

De huidige provisioning_state.

Opmerkingen

Geretourneerde waarden worden vermeld in de Naslaginformatie over de Azure REST API voor ProvisioningState.

list

Geef alle ComputeTarget-objecten in de werkruimte weer.

Retourneert een lijst met geïnstantieerde onderliggende objecten die overeenkomen met het specifieke type Compute. Objecten zijn onderliggende elementen van ComputeTarget.

static list(workspace)

Parameters

Name Description
workspace
Vereist

Het werkruimteobject met de objecten die moeten worden weergegeven.

Retouren

Type Description

Lijst met rekendoelen in de werkruimte.

Uitzonderingen

Type Description

refresh_state

Voer een in-place update uit van de eigenschappen van het object.

Eigenschappen bijwerken op basis van de huidige status van het bijbehorende cloudobject. Dit is handig voor handmatige polling van de rekenstatus.

Deze abstracte methode wordt geïmplementeerd door onderliggende klassen van ComputeTarget.

abstract refresh_state()

serialize

Converteer dit Compute-object naar een geserialiseerde JSON-woordenlijst.

abstract serialize()

Retouren

Type Description

De JSON-weergave van dit Compute-object.

wait_for_completion

Wacht tot de huidige inrichtingsbewerking is voltooid op het cluster.

Deze methode retourneert een ComputeTargetException als er een probleem is met het peilen van het rekenobject.

wait_for_completion(show_output=False, is_delete_operation=False)

Parameters

Name Description
show_output

Geeft aan of er uitgebreidere uitvoer moet worden opgegeven.

Default value: False
is_delete_operation

Hiermee wordt aangegeven of de bewerking is bedoeld voor het verwijderen.

Default value: False

Uitzonderingen

Type Description