ComputeTarget Classe
Classe padre astratta per tutte le destinazioni di calcolo gestite da Azure Machine Learning.
Una destinazione di calcolo è una risorsa/ambiente di calcolo designato in cui si esegue lo script di training o si ospita la distribuzione del servizio. Questo percorso può essere il computer locale o una risorsa di calcolo basata sul cloud. Per altre informazioni, vedere Che cosa sono le destinazioni di calcolo in Azure Machine Learning?
Costruttore ComputeTarget della classe.
Recuperare una rappresentazione cloud di un oggetto Compute associato all'area di lavoro specificata. Restituisce un'istanza di una classe figlio corrispondente al tipo specifico dell'oggetto Compute recuperato.
- Ereditarietà
-
ComputeTarget
Costruttore
ComputeTarget(workspace, name)
Parametri
Commenti
Usare il costruttore ComputeTarget per recuperare la rappresentazione cloud di un oggetto Compute associato all'area di lavoro specificata. Il costruttore restituisce un'istanza di una classe figlio corrispondente al tipo specifico dell'oggetto Compute recuperato. Se l'oggetto Compute non viene trovato, viene generato un oggetto ComputeTargetException .
Metodi
attach |
Collegare un oggetto Compute a un'area di lavoro usando il nome e le informazioni di configurazione specificati. |
create |
Effettuare il provisioning di un oggetto Compute specificando un tipo di calcolo e una configurazione correlata. Questo metodo crea una nuova destinazione di calcolo anziché collegarne una esistente. |
delete |
Rimuovere l'oggetto Calcolo dall'area di lavoro associata. Questo metodo astratto viene implementato dalle classi figlio di ComputeTarget. |
deserialize |
Convertire un oggetto JSON in un oggetto Compute. |
detach |
Scollegare l'oggetto Calcolo dall'area di lavoro associata. Questo metodo astratto viene implementato dalle classi figlio di ComputeTarget. Gli oggetti cloud sottostanti non vengono eliminati, ma vengono rimosse solo le associazioni. |
get_status |
Recuperare lo stato di provisioning corrente dell'oggetto Compute. |
list |
Elencare tutti gli oggetti ComputeTarget all'interno dell'area di lavoro. Restituisce un elenco di oggetti figlio di cui è stata creata un'istanza corrispondente al tipo specifico di calcolo. Gli oggetti sono elementi figlio di ComputeTarget. |
refresh_state |
Eseguire un aggiornamento sul posto delle proprietà dell'oggetto . Aggiornare le proprietà in base allo stato corrente dell'oggetto cloud corrispondente. Ciò è utile per il polling manuale dello stato di calcolo. Questo metodo astratto viene implementato dalle classi figlio di ComputeTarget. |
serialize |
Convertire questo oggetto Compute in un dizionario serializzato JSON. |
wait_for_completion |
Attendere il completamento dell'operazione di provisioning corrente nel cluster. Questo metodo restituisce un ComputeTargetException oggetto se si verifica un problema durante il polling dell'oggetto di calcolo. |
attach
Collegare un oggetto Compute a un'area di lavoro usando il nome e le informazioni di configurazione specificati.
static attach(workspace, name, attach_configuration)
Parametri
- attach_configuration
- ComputeTargetAttachConfiguration
Oggetto ComputeTargetAttachConfiguration usato per determinare il tipo di oggetto Compute da collegare e come configurarlo.
Restituisce
Istanza di un elemento figlio di ComputeTarget corrispondente al tipo di oggetto associato.
Tipo restituito
Eccezioni
Commenti
Il tipo di oggetto da passare al parametro attach_configuration
è un ComputeTargetAttachConfiguration oggetto compilato usando la attach_configuration
funzione in una delle classi figlio di ComputeTarget.
L'esempio seguente illustra come collegare un account ADLA a un'area di lavoro usando il attach_configuration metodo di 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))
L'esempio completo è disponibile da 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
Effettuare il provisioning di un oggetto Compute specificando un tipo di calcolo e una configurazione correlata.
Questo metodo crea una nuova destinazione di calcolo anziché collegarne una esistente.
static create(workspace, name, provisioning_configuration)
Parametri
- provisioning_configuration
- ComputeTargetProvisioningConfiguration
Oggetto ComputeTargetProvisioningConfiguration usato per determinare il tipo di oggetto Compute di cui effettuare il provisioning e come configurarlo.
Restituisce
Istanza di un elemento figlio di ComputeTarget corrispondente al tipo di oggetto di cui è stato effettuato il provisioning.
Tipo restituito
Eccezioni
Commenti
Il tipo di oggetto di cui è stato effettuato il provisioning è determinato dalla configurazione di provisioning fornita.
Nell'esempio seguente viene creata una destinazione di calcolo persistente di cui è stato effettuato il provisioning.AmlCompute Il provisioning_configuration
parametro in questo esempio è di tipo 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)
L'esempio completo è disponibile da https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb
delete
Rimuovere l'oggetto Calcolo dall'area di lavoro associata.
Questo metodo astratto viene implementato dalle classi figlio di ComputeTarget.
abstract delete()
Eccezioni
Commenti
Se questo oggetto è stato creato tramite Azure Machine Learning, verranno eliminati anche gli oggetti basati sul cloud corrispondenti. Se questo oggetto è stato creato esternamente e collegato solo all'area di lavoro, questo metodo genera un'eccezione e non viene modificato nulla.
deserialize
Convertire un oggetto JSON in un oggetto Compute.
abstract static deserialize(workspace, object_dict)
Parametri
Restituisce
Rappresentazione di calcolo dell'oggetto JSON fornito.
Tipo restituito
Eccezioni
Commenti
Genera un'eccezione ComputeTargetException se l'area di lavoro specificata non è l'area di lavoro a cui è associato l'ambiente di calcolo.
detach
Scollegare l'oggetto Calcolo dall'area di lavoro associata.
Questo metodo astratto viene implementato dalle classi figlio di ComputeTarget. Gli oggetti cloud sottostanti non vengono eliminati, ma vengono rimosse solo le associazioni.
abstract detach()
Eccezioni
get_status
Recuperare lo stato di provisioning corrente dell'oggetto Compute.
get_status()
Restituisce
Oggetto provisioning_state
corrente.
Tipo restituito
Eccezioni
Commenti
I valori restituiti sono elencati nella guida di riferimento all'API REST di Azure per ProvisioningState.
list
Elencare tutti gli oggetti ComputeTarget all'interno dell'area di lavoro.
Restituisce un elenco di oggetti figlio di cui è stata creata un'istanza corrispondente al tipo specifico di calcolo. Gli oggetti sono elementi figlio di ComputeTarget.
static list(workspace)
Parametri
Restituisce
Elenco di destinazioni di calcolo all'interno dell'area di lavoro.
Tipo restituito
Eccezioni
refresh_state
Eseguire un aggiornamento sul posto delle proprietà dell'oggetto .
Aggiornare le proprietà in base allo stato corrente dell'oggetto cloud corrispondente. Ciò è utile per il polling manuale dello stato di calcolo.
Questo metodo astratto viene implementato dalle classi figlio di ComputeTarget.
abstract refresh_state()
Eccezioni
serialize
Convertire questo oggetto Compute in un dizionario serializzato JSON.
abstract serialize()
Restituisce
Rappresentazione JSON di questo oggetto Compute.
Tipo restituito
Eccezioni
wait_for_completion
Attendere il completamento dell'operazione di provisioning corrente nel cluster.
Questo metodo restituisce un ComputeTargetException oggetto se si verifica un problema durante il polling dell'oggetto di calcolo.
wait_for_completion(show_output=False, is_delete_operation=False)
Parametri
- is_delete_operation
- bool
Indica se l'operazione è destinata all'eliminazione.
Eccezioni
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per