AdlaCompute クラス
Azure Machine Learning の Azure Data Lake Analytics コンピューティング ターゲットを管理します。
Azure Data Lake Analytics は、Azure クラウド内のビッグ データ分析プラットフォームです。 これは、Azure Machine Learning パイプラインでコンピューティング ターゲットとして使用できます。 詳細については、「Azure Machine Learning のコンピューティング先とは」を参照してください。
Class ComputeTarget コンストラクター。
指定されたワークスペースに関連付けられている Compute オブジェクトのクラウド表現を取得します。 取得した Compute オブジェクトの特定の型に対応する子クラスのインスタンスを返します。
コンストラクター
AdlaCompute(workspace, name)
パラメーター
| 名前 | 説明 |
|---|---|
|
workspace
必須
|
取得する AdlaCompute オブジェクトを含むワークスペース オブジェクト。 |
|
name
必須
|
取得する AdlaCompute オブジェクトの名前。 |
|
workspace
必須
|
取得する Compute オブジェクトを含むワークスペース オブジェクト。 |
|
name
必須
|
取得する Compute オブジェクトの名前。 |
注釈
使用する前に、Azure Data Lake Analytics アカウントを作成します。 作成するには、「 Azure Data Lake Analytics の概要」を参照してください。
次の例は、 attach_configuration メソッドを使用して ADLA アカウントをワークスペースにアタッチする方法を示しています。
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))
メソッド
| attach |
廃止。 代わりに 既存の Azure Data Lake Analytics コンピューティング リソースを指定されたワークスペースに関連付けます。 |
| attach_configuration |
Azure Data Lake Analytics コンピューティング ターゲットをアタッチするための構成オブジェクトを作成します。 |
| delete |
関連付けられているワークスペースから AdlaCompute オブジェクトを削除します。 このオブジェクトが Azure Machine Learning を使用して作成された場合、対応するクラウドベースのオブジェクトも削除されます。 このオブジェクトが外部で作成され、ワークスペースにのみアタッチされている場合は、 ComputeTargetException が発生し、何も変更されません。 |
| deserialize |
JSON オブジェクトを AdlaCompute オブジェクトに変換します。 |
| detach |
関連付けられているワークスペースから AdlaCompute オブジェクトをデタッチします。 基になるクラウド オブジェクトは削除されず、関連付けのみが削除されます。 |
| refresh_state |
オブジェクトのプロパティのインプレース更新を実行します。 このメソッドは、対応するクラウド オブジェクトの現在の状態に基づいてプロパティを更新します。 これは主に、コンピューティング状態の手動ポーリングに使用されます。 |
| serialize |
この AdlaCompute オブジェクトを JSON シリアル化ディクショナリに変換します。 |
attach
廃止。 代わりに attach_configuration メソッドを使用してください。
既存の Azure Data Lake Analytics コンピューティング リソースを指定されたワークスペースに関連付けます。
static attach(workspace, name, resource_id)
パラメーター
| 名前 | 説明 |
|---|---|
|
workspace
必須
|
コンピューティング リソースを関連付けるワークスペース オブジェクト。 |
|
name
必須
|
指定されたワークスペース内のコンピューティング リソースに関連付ける名前。 アタッチするコンピューティング リソースの名前と一致する必要はありません。 |
|
resource_id
必須
|
アタッチされているコンピューティング リソースの Azure リソース ID。 |
戻り値
| 型 | 説明 |
|---|---|
|
計算オブジェクトの AdlaCompute オブジェクト表現。 |
例外
| 型 | 説明 |
|---|---|
attach_configuration
Azure Data Lake Analytics コンピューティング ターゲットをアタッチするための構成オブジェクトを作成します。
static attach_configuration(resource_group=None, account_name=None, resource_id=None)
パラメーター
| 名前 | 説明 |
|---|---|
|
resource_group
|
Data Lake Analytics アカウントが配置されているリソース グループの名前。 規定値: None
|
|
account_name
|
Data Lake Analytics アカウント名です。 規定値: None
|
|
resource_id
|
アタッチされているコンピューティング リソースの Azure リソース ID。 規定値: None
|
戻り値
| 型 | 説明 |
|---|---|
|
コンピューティング オブジェクトをアタッチするときに使用する構成オブジェクト。 |
delete
関連付けられているワークスペースから AdlaCompute オブジェクトを削除します。
このオブジェクトが Azure Machine Learning を使用して作成された場合、対応するクラウドベースのオブジェクトも削除されます。 このオブジェクトが外部で作成され、ワークスペースにのみアタッチされている場合は、 ComputeTargetException が発生し、何も変更されません。
delete()
例外
| 型 | 説明 |
|---|---|
deserialize
JSON オブジェクトを AdlaCompute オブジェクトに変換します。
static deserialize(workspace, object_dict)
パラメーター
| 名前 | 説明 |
|---|---|
|
workspace
必須
|
AdlaCompute オブジェクトが関連付けられているワークスペース オブジェクト。 |
|
object_dict
必須
|
AdlaCompute オブジェクトに変換する JSON オブジェクト。 |
戻り値
| 型 | 説明 |
|---|---|
|
指定された JSON オブジェクトの AdlaCompute 表現。 |
例外
| 型 | 説明 |
|---|---|
注釈
指定されたワークスペースがコンピューティングが関連付けられているワークスペースでない場合は、 ComputeTargetException を発生させます。
detach
関連付けられているワークスペースから AdlaCompute オブジェクトをデタッチします。
基になるクラウド オブジェクトは削除されず、関連付けのみが削除されます。
detach()
例外
| 型 | 説明 |
|---|---|
refresh_state
オブジェクトのプロパティのインプレース更新を実行します。
このメソッドは、対応するクラウド オブジェクトの現在の状態に基づいてプロパティを更新します。 これは主に、コンピューティング状態の手動ポーリングに使用されます。
refresh_state()
serialize
この AdlaCompute オブジェクトを JSON シリアル化ディクショナリに変換します。
serialize()
戻り値
| 型 | 説明 |
|---|---|
|
この AdlaCompute オブジェクトの JSON 表現。 |