Compartilhar via


ComputeTarget Classe

Classe pai abstrata para todos os destinos de computação gerenciados pelo Azure Machine Learning.

Um destino de computação é um ambiente/recurso de computação designado em que você executa seu script de treinamento ou hospeda sua implantação de serviço. Esse local pode ser seu computador local ou um recurso de computação baseado em nuvem. Para obter mais informações, consulte O que são destinos de computação no Azure Machine Learning?

Construtor computeTarget de classe.

Recupere uma representação na nuvem de um objeto de computação associado ao workspace fornecido. Retorna uma instância de uma classe filho correspondente ao tipo específico do objeto compute recuperado.

Construtor

ComputeTarget(workspace, name)

Parâmetros

Nome Description
workspace
Obrigatório

O objeto de workspace que contém o objeto Compute a ser recuperado.

name
Obrigatório
str

O nome do objeto Compute a ser recuperado.

workspace
Obrigatório

O objeto de workspace que contém o objeto Compute a ser recuperado.

name
Obrigatório
str

O nome do objeto Compute a ser recuperado.

Comentários

Use o construtor ComputeTarget para recuperar a representação na nuvem de um objeto compute associado ao workspace fornecido. O construtor retorna uma instância de uma classe filho correspondente ao tipo específico do objeto compute recuperado. Se o objeto Compute não for encontrado, um ComputeTargetException será gerado.

Métodos

attach

Anexe um objeto compute a um workspace usando o nome e as informações de configuração especificadas.

create

Provisione um objeto de computação especificando um tipo de computação e uma configuração relacionada.

Esse método cria um novo destino de computação em vez de anexar um existente.

delete

Remova o objeto Compute de seu workspace associado.

Esse método abstrato é implementado por classes filho de ComputeTarget.

deserialize

Converta um objeto JSON em um objeto Compute.

detach

Desanexe o objeto Compute de seu workspace associado.

Esse método abstrato é implementado por classes filho de ComputeTarget. Objetos de nuvem subjacentes não são excluídos, apenas suas associações são removidas.

get_status

Recupere o estado de provisionamento atual do objeto Compute.

list

Liste todos os objetos ComputeTarget dentro do workspace.

Retornar uma lista de objetos filho instanciados correspondentes ao tipo específico de Computação. Objetos são filhos de ComputeTarget.

refresh_state

Execute uma atualização in-loco das propriedades do objeto.

Atualize as propriedades com base no estado atual do objeto de nuvem correspondente. Isso é útil para sondagem manual do estado de computação.

Esse método abstrato é implementado por classes filho de ComputeTarget.

serialize

Converta esse objeto compute em um dicionário serializado JSON.

wait_for_completion

Aguarde até que a operação de provisionamento atual seja concluída no cluster.

Esse método retorna um ComputeTargetException se houver um problema ao sondar o objeto de computação.

attach

Anexe um objeto compute a um workspace usando o nome e as informações de configuração especificadas.

static attach(workspace, name, attach_configuration)

Parâmetros

Nome Description
workspace
Obrigatório

O objeto de workspace ao qual anexar o objeto Compute.

name
Obrigatório
str

O nome a ser associado ao objeto Compute.

attach_configuration
Obrigatório

Um objeto ComputeTargetAttachConfiguration que é usado para determinar o tipo de objeto compute a ser anexado e como configurá-lo.

Retornos

Tipo Description

Uma instância de um filho de ComputeTarget correspondente ao tipo de objeto anexado.

Exceções

Tipo Description

Comentários

O tipo de objeto a ser passado para o parâmetro attach_configuration é um ComputeTargetAttachConfiguration objeto criado usando a attach_configuration função em qualquer uma das classes filho de ComputeTarget.

O exemplo a seguir mostra como anexar uma conta do ADLA a um workspace usando o attach_configuration método 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))

O exemplo completo está disponível em 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

Provisione um objeto de computação especificando um tipo de computação e uma configuração relacionada.

Esse método cria um novo destino de computação em vez de anexar um existente.

static create(workspace, name, provisioning_configuration)

Parâmetros

Nome Description
workspace
Obrigatório

O objeto de workspace no qual criar o objeto Compute.

name
Obrigatório
str

O nome a ser associado ao objeto Compute.

provisioning_configuration
Obrigatório

Um objeto ComputeTargetProvisioningConfiguration que é usado para determinar o tipo de objeto compute a ser provisionado e como configurá-lo.

Retornos

Tipo Description

Uma instância de um filho de ComputeTarget correspondente ao tipo de objeto provisionado.

Exceções

Tipo Description

Comentários

O tipo de objeto provisionado é determinado pela configuração de provisionamento fornecida.

No exemplo a seguir, um destino de computação persistente provisionado por AmlCompute ele é criado. O provisioning_configuration parâmetro neste exemplo é do 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)

O exemplo completo está disponível em https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb

delete

Remova o objeto Compute de seu workspace associado.

Esse método abstrato é implementado por classes filho de ComputeTarget.

abstract delete()

Comentários

Se esse objeto tiver sido criado por meio do Azure Machine Learning, os objetos baseados em nuvem correspondentes também serão excluídos. Se esse objeto tiver sido criado externamente e anexado apenas ao workspace, esse método gerará uma exceção e nada será alterado.

deserialize

Converta um objeto JSON em um objeto Compute.

abstract static deserialize(workspace, object_dict)

Parâmetros

Nome Description
workspace
Obrigatório

O objeto de workspace ao qual o objeto Compute está associado.

object_dict
Obrigatório

Um objeto JSON a ser convertido em um objeto compute.

Retornos

Tipo Description

A representação de computação do objeto JSON fornecido.

Comentários

Gera um ComputeTargetException se o workspace fornecido não for o workspace ao qual a computação está associada.

detach

Desanexe o objeto Compute de seu workspace associado.

Esse método abstrato é implementado por classes filho de ComputeTarget. Objetos de nuvem subjacentes não são excluídos, apenas suas associações são removidas.

abstract detach()

get_status

Recupere o estado de provisionamento atual do objeto Compute.

get_status()

Retornos

Tipo Description
str

O provisioning_state atual.

Comentários

Os valores retornados são listados na Referência da API REST do Azure para ProvisioningState.

list

Liste todos os objetos ComputeTarget dentro do workspace.

Retornar uma lista de objetos filho instanciados correspondentes ao tipo específico de Computação. Objetos são filhos de ComputeTarget.

static list(workspace)

Parâmetros

Nome Description
workspace
Obrigatório

O objeto de workspace que contém os objetos a serem listados.

Retornos

Tipo Description

Lista de destinos de computação dentro do workspace.

Exceções

Tipo Description

refresh_state

Execute uma atualização in-loco das propriedades do objeto.

Atualize as propriedades com base no estado atual do objeto de nuvem correspondente. Isso é útil para sondagem manual do estado de computação.

Esse método abstrato é implementado por classes filho de ComputeTarget.

abstract refresh_state()

serialize

Converta esse objeto compute em um dicionário serializado JSON.

abstract serialize()

Retornos

Tipo Description

A representação JSON deste objeto compute.

wait_for_completion

Aguarde até que a operação de provisionamento atual seja concluída no cluster.

Esse método retorna um ComputeTargetException se houver um problema ao sondar o objeto de computação.

wait_for_completion(show_output=False, is_delete_operation=False)

Parâmetros

Nome Description
show_output

Indica se a saída deve ser mais detalhada.

Valor padrão: False
is_delete_operation

Indica se a operação destina-se à exclusão.

Valor padrão: False

Exceções

Tipo Description