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

Nome Descrizione
workspace
Necessario

Oggetto workspace contenente l'oggetto Compute da recuperare.

name
Necessario
str

Nome dell'oggetto Compute da recuperare.

workspace
Necessario

Oggetto workspace contenente l'oggetto Compute da recuperare.

name
Necessario
str

Nome dell'oggetto Compute da recuperare.

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

Nome Descrizione
workspace
Necessario

Oggetto workspace a cui collegare l'oggetto Compute.

name
Necessario
str

Nome da associare all'oggetto Compute.

attach_configuration
Necessario

Oggetto ComputeTargetAttachConfiguration usato per determinare il tipo di oggetto Compute da collegare e come configurarlo.

Restituisce

Tipo Descrizione

Istanza di un elemento figlio di ComputeTarget corrispondente al tipo di oggetto associato.

Eccezioni

Tipo Descrizione

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

Nome Descrizione
workspace
Necessario

Oggetto workspace in cui creare l'oggetto Compute.

name
Necessario
str

Nome da associare all'oggetto Compute.

provisioning_configuration
Necessario

Oggetto ComputeTargetProvisioningConfiguration usato per determinare il tipo di oggetto Compute di cui effettuare il provisioning e come configurarlo.

Restituisce

Tipo Descrizione

Istanza di un elemento figlio di ComputeTarget corrispondente al tipo di oggetto di cui è stato effettuato il provisioning.

Eccezioni

Tipo Descrizione

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

Tipo Descrizione

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

Nome Descrizione
workspace
Necessario

L'oggetto workspace a cui è associato l'oggetto Compute.

object_dict
Necessario

Oggetto JSON da convertire in un oggetto Compute.

Restituisce

Tipo Descrizione

Rappresentazione di calcolo dell'oggetto JSON fornito.

Eccezioni

Tipo Descrizione

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

Tipo Descrizione

get_status

Recuperare lo stato di provisioning corrente dell'oggetto Compute.

get_status()

Restituisce

Tipo Descrizione
str

Oggetto provisioning_state corrente.

Eccezioni

Tipo Descrizione

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

Nome Descrizione
workspace
Necessario

Oggetto area di lavoro contenente gli oggetti da elencare.

Restituisce

Tipo Descrizione

Elenco di destinazioni di calcolo all'interno dell'area di lavoro.

Eccezioni

Tipo Descrizione

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

Tipo Descrizione

serialize

Convertire questo oggetto Compute in un dizionario serializzato JSON.

abstract serialize()

Restituisce

Tipo Descrizione

Rappresentazione JSON di questo oggetto Compute.

Eccezioni

Tipo Descrizione

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

Nome Descrizione
show_output

Indica se fornire un output più dettagliato.

Valore predefinito: False
is_delete_operation

Indica se l'operazione è destinata all'eliminazione.

Valore predefinito: False

Eccezioni

Tipo Descrizione