ComputeTarget Klas

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

Een rekendoel is een aangewezen rekenresource/-omgeving waar u uw trainingsscript uitvoert of uw service-implementatie host. Deze locatie kan uw lokale computer of een cloudgebaseerde rekenresource zijn. 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.

Overname

ABC

ComputeTarget

Constructor

ComputeTarget(workspace, name)

Parameters

Name	Description
workspace Vereist	Workspace Het werkruimteobject met het rekenobject dat moet worden opgehaald.
name Vereist	str De naam van het rekenobject dat moet worden opgehaald.
workspace Vereist	Workspace Het werkruimteobject met het rekenobject dat moet worden opgehaald.
name Vereist	str De naam van het rekenobject dat moet worden opgehaald.

Opmerkingen

Gebruik de constructor ComputeTarget 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 een ComputeTargetException gegenereerd.

Methoden

attach	Koppel een Compute-object aan een werkruimte met behulp van de opgegeven naam en configuratiegegevens.
create	Richt een Compute-object in door een rekentype en een gerelateerde configuratie op te geven. Met deze methode maakt u een nieuw rekendoel in plaats van een bestaand rekendoel 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	Alle ComputeTarget-objecten in de werkruimte weergeven. 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 van de eigenschappen van het object uit. Eigenschappen bijwerken op basis van de huidige status van het bijbehorende cloudobject. Dit is handig voor het handmatig peilen 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 Compute-object aan een werkruimte met behulp van de opgegeven naam en configuratiegegevens.

static attach(workspace, name, attach_configuration)

Parameters

Name	Description
workspace Vereist	Workspace 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	ComputeTargetAttachConfiguration Een ComputeTargetAttachConfiguration-object dat wordt gebruikt om het type compute-object te bepalen dat moet worden gekoppeld en hoe dit moet worden geconfigureerd.

Retouren

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

Uitzonderingen

Type	Description
ComputeTargetException

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 koppelt aan een werkruimte met behulp van de attach_configuration methode van 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))

Het volledige voorbeeld is beschikbaar via 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 Compute-object in door een rekentype en een gerelateerde configuratie op te geven.

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

static create(workspace, name, provisioning_configuration)

Parameters

Name	Description
workspace Vereist	Workspace Het werkruimteobject waaronder het compute-object moet worden gemaakt.
name Vereist	str De naam die moet worden gekoppeld aan het compute-object.
provisioning_configuration Vereist	ComputeTargetProvisioningConfiguration Een ComputeTargetProvisioningConfiguration-object dat wordt gebruikt om het type rekenobject te bepalen dat moet worden ingericht en hoe dit moet worden geconfigureerd.

Retouren

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

Uitzonderingen

Type	Description
ComputeTargetException

Opmerkingen

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

In het volgende voorbeeld wordt een permanent rekendoel gemaakt dat is ingericht door AmlCompute . 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)

Het volledige voorbeeld is beschikbaar via 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()

Uitzonderingen

Type	Description
ComputeTargetException

Opmerkingen

Als dit object is gemaakt via Azure Machine Learning, worden de bijbehorende cloudobjecten ook verwijderd. Als dit object extern is gemaakt en alleen aan de werkruimte is gekoppeld, 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	Workspace Het werkruimteobject waar het object Compute aan is gekoppeld.
object_dict Vereist	dict Een JSON-object dat moet worden geconverteerd naar een Compute-object.

Retouren

Type	Description
ComputeTarget	De berekeningsweergave van het opgegeven JSON-object.

Uitzonderingen

Type	Description
ComputeTargetException

Opmerkingen

Genereert een ComputeTargetException als de opgegeven werkruimte niet de werkruimte is waar de compute aan 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()

Uitzonderingen

Type	Description
ComputeTargetException

get_status

Haal de huidige inrichtingsstatus van het compute-object op.

get_status()

Retouren

Type	Description
str	De huidige provisioning_state.

Uitzonderingen

Type	Description
ComputeTargetException

Opmerkingen

Geretourneerde waarden worden vermeld in de Azure REST API-verwijzing voor ProvisioningState.

list

Alle ComputeTarget-objecten in de werkruimte weergeven.

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	Workspace Het werkruimteobject met de objecten die u wilt weergeven.

Retouren

Type	Description
list[ComputeTarget]	Lijst met rekendoelen in de werkruimte.

Uitzonderingen

Type	Description
ComputeTargetException

refresh_state

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

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

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

abstract refresh_state()

Uitzonderingen

Type	Description
ComputeTargetException

serialize

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

abstract serialize()

Retouren

Type	Description
dict	De JSON-weergave van dit Compute-object.

Uitzonderingen

Type	Description
ComputeTargetException

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	bool Hiermee wordt aangegeven of uitgebreidere uitvoer moet worden geboden. Default value: False
is_delete_operation	bool Hiermee wordt aangegeven of de bewerking is bedoeld om te worden verwijderd. Default value: False

Uitzonderingen

Type	Description
ComputeTargetException