Partilhar via


ComputeTarget Classe

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

Um destino de computação é um ambiente/recurso de computação designado onde executa o script de preparação ou aloja a implementação do serviço. Esta localização pode ser o seu computador local ou um recurso de computação baseado na cloud. Para obter mais informações, veja O que são os destinos de computação no Azure Machine Learning?

Construtor Class ComputeTarget.

Obtenha uma representação na cloud de um objeto de Computação associado à área de trabalho fornecida. Devolve uma instância de uma classe subordinada correspondente ao tipo específico do objeto de Computação obtido.

Herança
ComputeTarget

Construtor

ComputeTarget(workspace, name)

Parâmetros

Name Description
workspace
Necessário

O objeto da área de trabalho que contém o objeto Computação a obter.

name
Necessário
str

O nome do objeto Computação a obter.

workspace
Necessário

O objeto da área de trabalho que contém o objeto Computação a obter.

name
Necessário
str

O nome do objeto Computação a obter.

Observações

Utilize o construtor ComputeTarget para obter a representação na cloud de um objeto de Computação associado à área de trabalho fornecida. O construtor devolve uma instância de uma classe subordinada correspondente ao tipo específico do objeto de Computação obtido. Se o objeto Computação não for encontrado, é gerado um ComputeTargetException .

Métodos

attach

Anexe um objeto de Computação a uma área de trabalho com o nome especificado e as informações de configuração.

create

Aprovisione um objeto de Computação ao especificar um tipo de computação e uma configuração relacionada.

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

delete

Remova o objeto Computação da área de trabalho associada.

Este método abstrato é implementado por classes subordinadas de ComputeTarget.

deserialize

Converter um objeto JSON num objeto de Computação.

detach

Desanexe o objeto Computação da área de trabalho associada.

Este método abstrato é implementado por classes subordinadas de ComputeTarget. Os objetos subjacentes à cloud não são eliminados, apenas as associações são removidas.

get_status

Obtenha o estado de aprovisionamento atual do objeto Computação.

list

Listar todos os objetos ComputeTarget na área de trabalho.

Devolver uma lista de objetos subordinados instanciados correspondentes ao tipo específico de Computação. Os objetos são subordinados de ComputeTarget.

refresh_state

Efetue uma atualização no local das propriedades do objeto.

Atualize as propriedades com base no estado atual do objeto de cloud correspondente. Isto é útil para consultas manuais do estado de computação.

Este método abstrato é implementado por classes subordinadas de ComputeTarget.

serialize

Converta este objeto de Computação num dicionário serializado JSON.

wait_for_completion

Aguarde que a operação de aprovisionamento atual termine no cluster.

Este método devolve um ComputeTargetException se houver um problema ao consultar o objeto de computação.

attach

Anexe um objeto de Computação a uma área de trabalho com o nome especificado e as informações de configuração.

static attach(workspace, name, attach_configuration)

Parâmetros

Name Description
workspace
Necessário

O objeto da área de trabalho ao qual anexar o objeto Computação.

name
Necessário
str

O nome a associar ao objeto Computação.

attach_configuration
Necessário

Um objeto ComputeTargetAttachConfiguration que é utilizado para determinar o tipo de objeto de Computação a anexar e como configurá-lo.

Devoluções

Tipo Description

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

Exceções

Tipo Description

Observações

O tipo de objeto a transmitir para o parâmetro attach_configuration é um ComputeTargetAttachConfiguration objeto criado com a attach_configuration função em qualquer uma das classes subordinadas de ComputeTarget.

O exemplo seguinte mostra como anexar uma conta do ADLA a uma área de trabalho com 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 a partir de 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

Aprovisione um objeto de Computação ao especificar um tipo de computação e uma configuração relacionada.

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

static create(workspace, name, provisioning_configuration)

Parâmetros

Name Description
workspace
Necessário

O objeto da área de trabalho para criar o objeto Computação em.

name
Necessário
str

O nome a associar ao objeto Computação.

provisioning_configuration
Necessário

Um objeto ComputeTargetProvisioningConfiguration que é utilizado para determinar o tipo de objeto de Computação a aprovisionar e como configurá-lo.

Devoluções

Tipo Description

Uma instância de um subordinado de ComputeTarget correspondente ao tipo de objeto aprovisionado.

Exceções

Tipo Description

Observações

O tipo de objeto aprovisionado é determinado pela configuração de aprovisionamento fornecida.

No exemplo seguinte, é criado um destino de computação persistente aprovisionado por AmlCompute . 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 a partir de https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb

delete

Remova o objeto Computação da área de trabalho associada.

Este método abstrato é implementado por classes subordinadas de ComputeTarget.

abstract delete()

Exceções

Tipo Description

Observações

Se este objeto tiver sido criado através do Azure Machine Learning, os objetos baseados na cloud correspondentes também serão eliminados. Se este objeto tiver sido criado externamente e apenas anexado à área de trabalho, este método gera uma exceção e nada é alterado.

deserialize

Converter um objeto JSON num objeto de Computação.

abstract static deserialize(workspace, object_dict)

Parâmetros

Name Description
workspace
Necessário

O objeto de área de trabalho ao que o objeto Computação está associado.

object_dict
Necessário

Um objeto JSON para converter num objeto de Computação.

Devoluções

Tipo Description

A representação computacional do objeto JSON fornecido.

Exceções

Tipo Description

Observações

Gera um ComputeTargetException se a área de trabalho fornecida não for a área de trabalho à que a Computação está associada.

detach

Desanexe o objeto Computação da área de trabalho associada.

Este método abstrato é implementado por classes subordinadas de ComputeTarget. Os objetos subjacentes à cloud não são eliminados, apenas as associações são removidas.

abstract detach()

Exceções

Tipo Description

get_status

Obtenha o estado de aprovisionamento atual do objeto Computação.

get_status()

Devoluções

Tipo Description
str

O atual provisioning_state.

Exceções

Tipo Description

Observações

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

list

Listar todos os objetos ComputeTarget na área de trabalho.

Devolver uma lista de objetos subordinados instanciados correspondentes ao tipo específico de Computação. Os objetos são subordinados de ComputeTarget.

static list(workspace)

Parâmetros

Name Description
workspace
Necessário

O objeto da área de trabalho que contém os objetos a listar.

Devoluções

Tipo Description

Lista de destinos de computação na área de trabalho.

Exceções

Tipo Description

refresh_state

Efetue uma atualização no local das propriedades do objeto.

Atualize as propriedades com base no estado atual do objeto de cloud correspondente. Isto é útil para consultas manuais do estado de computação.

Este método abstrato é implementado por classes subordinadas de ComputeTarget.

abstract refresh_state()

Exceções

Tipo Description

serialize

Converta este objeto de Computação num dicionário serializado JSON.

abstract serialize()

Devoluções

Tipo Description

A representação JSON deste objeto de Computação.

Exceções

Tipo Description

wait_for_completion

Aguarde que a operação de aprovisionamento atual termine no cluster.

Este método devolve um ComputeTargetException se houver um problema ao consultar o objeto de computação.

wait_for_completion(show_output=False, is_delete_operation=False)

Parâmetros

Name Description
show_output

Indica se pretende fornecer uma saída mais verbosa.

Default value: False
is_delete_operation

Indica se a operação se destina a eliminar.

Default value: False

Exceções

Tipo Description