ComputeTarget Класс

Подключение объекта вычислений к рабочей области с использованием указанного имени и сведений о конфигурации.

static attach(workspace, name, attach_configuration)

Параметры

Возвращаемое значение

Исключения

Комментарии

Тип объекта, передаваемого в параметр attach_configuration, представляет собой объект ComputeTargetAttachConfiguration, созданный с помощью функции attach_configuration в любом дочернем классе ComputeTarget.

В следующем примере показано, как подключить учетную запись ADLA к рабочей области с помощью метода attach_configuration 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))

Полный пример можно найти здесь: 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

Подготовка объекта вычислений путем указания типа вычислений и связанной с ним конфигурации.

Этот метод создает новый целевой объект вычислений, а не подключает существующий.

static create(workspace, name, provisioning_configuration)

Параметры

Возвращаемое значение

Исключения

Комментарии

Тип подготавливаемого объекта определяется предоставленной конфигурацией подготовки.

В следующем примере создается постоянный объект вычислений, подготовленный с помощью AmlCompute. Параметр provisioning_configuration в этом примере относится к типу 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)

Полный пример можно найти здесь: https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb

Удаление объекта вычислений из связанной с ним рабочей области.

Этот абстрактный метод реализуется дочерними классами ComputeTarget.

abstract delete()

Исключения

Комментарии

Если этот объект был создан с помощью Машинного обучения Azure, будут удалены и соответствующие облачные объекты. Если этот объект был создан во внешней среде и просто подключен к рабочей области, данный метод генерирует исключение, ничего не изменяя.

Преобразование объекта JSON в объект вычислений.

abstract static deserialize(workspace, object_dict)

Параметры

Возвращаемое значение

Исключения

Комментарии

Генерирует ComputeTargetException, если указана не та рабочая область, с которой связано вычисление.

Отсоединение объекта вычислений от связанной с ним рабочей области.

Этот абстрактный метод реализуется дочерними классами ComputeTarget. Базовые облачные объекты при этом сохраняются, удаляются только их связи.

abstract detach()

Исключения

Получение текущего состояния подготовки объекта вычислений.

get_status()

Возвращаемое значение

Исключения

Комментарии

Возвращаемые значения приведены в справочнике по REST API Azure для ProvisioningState.

Список всех объектов ComputeTarget в рабочей области.

Возврат списка экземпляров дочерних объектов, соответствующих определенному типу вычислений. Они являются дочерними объектами ComputeTarget.

static list(workspace)

Параметры

Возвращаемое значение

Исключения

Выполнение обновлений свойств объекта на месте.

Обновление свойств согласно текущему состоянию соответствующего облачного объекта. Это полезно при опросе состояния вычислений вручную.

Этот абстрактный метод реализуется дочерними классами ComputeTarget.

abstract refresh_state()

Исключения

Преобразование этого объекта вычислений в сериализованный словарь JSON.

abstract serialize()

Возвращаемое значение

Исключения

Ожидание завершения текущей операции подготовки в кластере.

Этот метод возвращает значение ComputeTargetException, если возникла проблема при опросе объекта вычислений.

wait_for_completion(show_output=False, is_delete_operation=False)

Параметры

Исключения