BatchCompute クラス

  • リファレンス

Azure Machine Learning の Batch コンピューティング先を管理します。

Azure Batch は、大規模な並列コンピューティングやハイパフォーマンス コンピューティング (HPC) のアプリケーションをクラウドで効率的に実行するために使用されます。 BatchCompute は、AzureBatchStep を使用してマシンの Azure Batch プールにジョブを送信するために Azure Machine Learning パイプラインで使用されます。 詳細については、「Azure Machine Learning でのコンピューティング先とは」を参照してください。

ComputeTarget クラスコンストラクター。

指定されたワークスペースに関連付けられている Compute オブジェクトのクラウド表現を取得します。 取得した Compute オブジェクトの特定の型に対応する子クラスのインスタンスを返します。

継承
ComputeTarget
BatchCompute

コンストラクター

BatchCompute(workspace, name)

パラメーター

名前 説明
workspace
必須
Workspace

取得する BatchCompute オブジェクトを含むワークスペース オブジェクト。
name
必須
str

取得する BatchCompute オブジェクトの名前。
workspace
必須
Workspace

取得する Compute オブジェクトを含むワークスペース オブジェクト。
name
必須
str

取得する Compute オブジェクトの 名前。

注釈

使用する前に Azure Batch アカウントを作成します。 作成する方法については、「Azure Portal で Batch アカウントを作成する」を参照してください。

次の例では、attach_configuration を使用して Azure Batch コンピューティング アカウントをワークスペースにアタッチする方法を示します。


   batch_compute_name = 'mybatchcompute' # Name to associate with new compute in workspace

   # Batch account details needed to attach as compute to workspace
   batch_account_name = "<batch_account_name>" # Name of the Batch account
   batch_resource_group = "<batch_resource_group>" # Name of the resource group which contains this account

   try:
       # check if already attached
       batch_compute = BatchCompute(ws, batch_compute_name)
   except ComputeTargetException:
       print('Attaching Batch compute...')
       provisioning_config = BatchCompute.attach_configuration(resource_group=batch_resource_group,
                                                               account_name=batch_account_name)
       batch_compute = ComputeTarget.attach(ws, batch_compute_name, provisioning_config)
       batch_compute.wait_for_completion()
       print("Provisioning state:{}".format(batch_compute.provisioning_state))
       print("Provisioning errors:{}".format(batch_compute.provisioning_errors))

   print("Using Batch compute:{}".format(batch_compute.cluster_resource_id))

完全なサンプルは、https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/machine-learning-pipelines/intro-to-pipelines/aml-pipelines-how-to-use-azurebatch-to-run-a-windows-executable.ipynb から入手できます

メソッド

attach_configuration

Batch コンピューティング先をアタッチするための構成オブジェクトを作成します。
delete

BatchCompute オブジェクトでは、削除はサポートされていません。 代わりに detach を使用してください
deserialize

JSON オブジェクトを BatchCompute オブジェクトに変換します。
detach

関連付けられているワークスペースから Batch オブジェクトをデタッチします。

基になるクラウド オブジェクトは削除されません。関連付けのみが削除されます。
refresh_state

オブジェクトのプロパティのインプレース更新を実行します。

このメソッドは、対応するクラウド オブジェクトの現在の状態に基づいてプロパティを更新します。 これは主に、コンピューティング状態の手動ポーリングに使用されます。
serialize

この BatchCompute オブジェクトを JSON のシリアル化された辞書に変換します。

attach_configuration

Batch コンピューティング先をアタッチするための構成オブジェクトを作成します。

static attach_configuration(resource_group=None, account_name=None, resource_id=None)

パラメーター

名前 説明
resource_group
str

Batch アカウントが存在するリソース グループの名前。

規定値: None
account_name
str

Batch アカウントの名前。

規定値: None
resource_id
str

アタッチされているコンピューティング リソースの Azure リソース ID。

規定値: None

戻り値

型 説明
BatchAttachConfiguration

コンピューティング オブジェクトをアタッチするときに使用する構成オブジェクト。

delete

BatchCompute オブジェクトでは、削除はサポートされていません。 代わりに detach を使用してください

delete()

例外

型 説明
ComputeTargetException

deserialize

JSON オブジェクトを BatchCompute オブジェクトに変換します。

static deserialize(workspace, object_dict)

パラメーター

名前 説明
workspace
必須
Workspace

BatchCompute オブジェクトが関連付けられているワークスペース オブジェクト。
object_dict
必須
dict

BatchCompute オブジェクトに変換する JSON オブジェクト。

戻り値

型 説明
BatchCompute

指定された JSON オブジェクトの BatchCompute 表現。

例外

型 説明
ComputeTargetException

注釈

指定されたワークスペースが、Compute が関連付けられているワークスペースではない場合、ComputeTargetException を発生させます。

detach

関連付けられているワークスペースから Batch オブジェクトをデタッチします。

基になるクラウド オブジェクトは削除されません。関連付けのみが削除されます。

detach()

例外

型 説明
ComputeTargetException

refresh_state

オブジェクトのプロパティのインプレース更新を実行します。

このメソッドは、対応するクラウド オブジェクトの現在の状態に基づいてプロパティを更新します。 これは主に、コンピューティング状態の手動ポーリングに使用されます。

refresh_state()

serialize

この BatchCompute オブジェクトを JSON のシリアル化された辞書に変換します。

serialize()

戻り値

型 説明
dict

この BatchCompute オブジェクトの JSON 表現。