ComputeTarget Classe
Classe pai abstrata para todos os destinos de computação gerenciados pelo Azure Machine Learning.
Um destino de computação é um recurso/ambiente de computação designado onde você executa seu script de treinamento ou hospeda sua implantação de serviço. Esse local pode ser sua máquina 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?
Classe ComputeTarget construtor.
Recupere uma representação na nuvem de um objeto Compute associado ao espaço de trabalho fornecido. Retorna uma instância de uma classe filho correspondente ao tipo específico do objeto Compute recuperado.
Construtor
ComputeTarget(workspace, name)
Parâmetros
| Name | Description |
|---|---|
|
workspace
Necessário
|
O objeto de espaço de trabalho que contém o objeto Compute a ser recuperado. |
|
name
Necessário
|
O nome do objeto Compute a ser recuperado. |
|
workspace
Necessário
|
O objeto de espaço de trabalho que contém o objeto Compute a ser recuperado. |
|
name
Necessário
|
O nome do objeto Compute a ser recuperado. |
Observações
Use o construtor ComputeTarget para recuperar a representação na nuvem de um objeto Compute associado ao espaço de trabalho 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 espaço de trabalho usando o nome especificado e as informações de configuração. |
| create |
Provisione um objeto Compute especificando um tipo de computação e 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 espaço de trabalho associado. Este método abstrato é implementado por classes filhas de ComputeTarget. |
| deserialize |
Converter um objeto JSON em um objeto Compute. |
| detach |
Desanexe o objeto Compute de seu espaço de trabalho associado. Este método abstrato é implementado por classes filhas de ComputeTarget. Os 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 espaço de trabalho. Retorna uma lista de objetos filho instanciados correspondentes ao tipo específico de Computação. Os 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. Este método abstrato é implementado por classes filhas de ComputeTarget. |
| serialize |
Converta este 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 espaço de trabalho usando 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 de espaço de trabalho ao qual anexar o objeto Compute. |
|
name
Necessário
|
O nome a ser associado ao objeto Compute. |
|
attach_configuration
Necessário
|
Um objeto ComputeTargetAttachConfiguration que é usado para determinar o tipo de objeto Compute a ser anexado e como configurá-lo. |
Devoluções
| Tipo | Description |
|---|---|
|
Uma instância de um filho de ComputeTarget correspondente ao tipo de objeto anexado. |
Exceções
| Tipo | Description |
|---|---|
Observações
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 ADLA a um espaço de trabalho 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))
A amostra completa 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 Compute especificando um tipo de computação e 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
| Name | Description |
|---|---|
|
workspace
Necessário
|
O objeto de espaço de trabalho para criar o objeto Compute em. |
|
name
Necessário
|
O nome a ser associado ao objeto Compute. |
|
provisioning_configuration
Necessário
|
Um objeto ComputeTargetProvisioningConfiguration que é usado para determinar o tipo de objeto Compute a ser provisionado e como configurá-lo. |
Devoluções
| Tipo | Description |
|---|---|
|
Uma instância de um filho de ComputeTarget correspondente ao tipo de objeto provisionado. |
Exceções
| Tipo | Description |
|---|---|
Observações
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 é 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)
A amostra completa 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 espaço de trabalho associado.
Este método abstrato é implementado por classes filhas de ComputeTarget.
abstract delete()
Observações
Se este objeto tiver sido criado através do Azure Machine Learning, os objetos baseados na nuvem correspondentes também serão eliminados. Se esse objeto foi criado externamente e anexado apenas ao espaço de trabalho, esse método gera uma exceção e nada é alterado.
deserialize
Converter um objeto JSON em um objeto Compute.
abstract static deserialize(workspace, object_dict)
Parâmetros
| Name | Description |
|---|---|
|
workspace
Necessário
|
O objeto de espaço de trabalho ao qual o objeto Compute está associado. |
|
object_dict
Necessário
|
Um objeto JSON para converter em um objeto Compute. |
Devoluções
| Tipo | Description |
|---|---|
|
A representação Compute do objeto JSON fornecido. |
Observações
Gera um ComputeTargetException se o espaço de trabalho fornecido não for o espaço de trabalho ao qual a computação está associada.
detach
Desanexe o objeto Compute de seu espaço de trabalho associado.
Este método abstrato é implementado por classes filhas de ComputeTarget. Os 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()
Devoluções
| Tipo | Description |
|---|---|
|
A |
Observações
Os valores retornados são listados na Referência da API REST do Azure para ProvisioningState.
list
Liste todos os objetos ComputeTarget dentro do espaço de trabalho.
Retorna uma lista de objetos filho instanciados correspondentes ao tipo específico de Computação. Os objetos são filhos de ComputeTarget.
static list(workspace)
Parâmetros
| Name | Description |
|---|---|
|
workspace
Necessário
|
O objeto de espaço de trabalho que contém os objetos a serem listados. |
Devoluções
| Tipo | Description |
|---|---|
|
Lista de destinos de computação no espaço de trabalho. |
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.
Este método abstrato é implementado por classes filhas de ComputeTarget.
abstract refresh_state()
serialize
Converta este objeto Compute em um dicionário serializado JSON.
abstract serialize()
Devoluções
| 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
| Name | Description |
|---|---|
|
show_output
|
Indica se a saída deve ser mais detalhada. Default value: False
|
|
is_delete_operation
|
Indica se a operação se destina a exclusão. Default value: False
|
Exceções
| Tipo | Description |
|---|---|