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
|
De naam van het rekenobject dat moet worden opgehaald. |
|
workspace
Vereist
|
Het werkruimteobject met het rekenobject dat moet worden opgehaald. |
|
name
Vereist
|
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
|
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
|
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 |
|---|---|
|
De huidige |
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 |
|---|---|