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
-
ComputeTarget
Konstruktor
ComputeTarget(workspace, name)
Parametrar
Name | Description |
---|---|
workspace
Obligatorisk
|
Arbetsyteobjektet som innehåller beräkningsobjektet som ska hämtas. |
name
Obligatorisk
|
Namnet på beräkningsobjektet som ska hämtas. |
workspace
Obligatorisk
|
Arbetsyteobjektet som innehåller beräkningsobjektet som ska hämtas. |
name
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
Name | Description |
---|---|
workspace
Obligatorisk
|
Det arbetsyteobjekt som beräkningsobjektet ska kopplas till. |
name
Obligatorisk
|
Namnet som ska associeras med Compute-objektet. |
attach_configuration
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
Typ | Description |
---|---|
En instans av ett underordnat ComputeTarget som motsvarar den typ av objekt som är kopplat. |
Undantag
Typ | Description |
---|---|
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
Name | Description |
---|---|
workspace
Obligatorisk
|
Det arbetsyteobjekt som beräkningsobjektet ska skapas under. |
name
Obligatorisk
|
Namnet som ska associeras med Compute-objektet. |
provisioning_configuration
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
Typ | Description |
---|---|
En instans av ett underordnat ComputeTarget som motsvarar den typ av objekt som etablerats. |
Undantag
Typ | Description |
---|---|
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 |
---|---|
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
Name | Description |
---|---|
workspace
Obligatorisk
|
Arbetsyteobjektet som Compute-objektet är associerat med. |
object_dict
Obligatorisk
|
Ett JSON-objekt som ska konverteras till ett Compute-objekt. |
Returer
Typ | Description |
---|---|
Beräkningsrepresentationen av det angivna JSON-objektet. |
Undantag
Typ | Description |
---|---|
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
Typ | Description |
---|---|
get_status
Hämta det aktuella etableringstillståndet för Compute-objektet.
get_status()
Returer
Typ | Description |
---|---|
|
Undantag
Typ | Description |
---|---|
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
Name | Description |
---|---|
workspace
Obligatorisk
|
Arbetsyteobjektet som innehåller objekten som ska listas. |
Returer
Typ | Description |
---|---|
Lista över beräkningsmål på arbetsytan. |
Undantag
Typ | Description |
---|---|
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 |
---|---|
serialize
Konvertera det här Compute-objektet till en JSON-serialiserad ordlista.
abstract serialize()
Returer
Typ | Description |
---|---|
JSON-representationen av det här Compute-objektet. |
Undantag
Typ | Description |
---|---|
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
|
Anger om du vill ge mer utförliga utdata. Standardvärde: False
|
is_delete_operation
|
Anger om åtgärden är avsedd för borttagning. Standardvärde: False
|
Undantag
Typ | Description |
---|---|