DataFactoryCompute Class

Manages a DataFactory compute target in Azure Machine Learning.

Azure Data Factory is Azure's cloud ETL service for scale-out serverless data integration and data transformation. For more information, see Azure Data Factory.

Class ComputeTarget constructor.

Retrieve a cloud representation of a Compute object associated with the provided workspace. Returns an instance of a child class corresponding to the specific type of the retrieved Compute object.

Inheritance
DataFactoryCompute

Constructor

DataFactoryCompute(workspace, name)

Parameters

Name Description
workspace
Required

The workspace object containing the DataFactoryCompute object to retrieve.

name
Required
str

The name of the DataFactoryCompute object to retrieve.

workspace
Required

The workspace object containing the Compute object to retrieve.

name
Required
str

The name of the of the Compute object to retrieve.

Methods

attach

DEPRECATED. Use the attach_configuration method instead.

Associate an existing DataFactory compute resource with the provided workspace.

attach_configuration

Create a configuration object for attaching a DataFactory compute target.

delete

Remove the DatafactoryCompute object from its associated workspace.

deserialize

Convert a JSON object into a DataFactoryCompute object.

detach

Detach the Datafactory object from its associated workspace.

Underlying cloud objects are not deleted, only the association is removed.

provisioning_configuration

Create a configuration object for provisioning a DataFactoryCompute target.

refresh_state

Perform an in-place update of the properties of the object.

This method updates the properties based on the current state of the corresponding cloud object. This is primarily used for manual polling of compute state.

serialize

Convert this DataFactoryCompute object into a JSON serialized dictionary.

attach

DEPRECATED. Use the attach_configuration method instead.

Associate an existing DataFactory compute resource with the provided workspace.

static attach(workspace, name, resource_id)

Parameters

Name Description
workspace
Required

The workspace object to associate the compute resource with.

name
Required
str

The name to associate with the compute resource inside the provided workspace. Does not have to match the name of the compute resource to be attached.

resource_id
Required
str

The Azure resource ID for the compute resource being attached.

Returns

Type Description

A DataFactoryCompute object representation of the compute object.

Exceptions

Type Description

attach_configuration

Create a configuration object for attaching a DataFactory compute target.

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

Parameters

Name Description
resource_group
str

The name of the resource group in which the DataFactory is located.

Default value: None
factory_name
str

The DataFactory name.

Default value: None
resource_id
str

The Azure resource ID for the compute resource being attached.

Default value: None

Returns

Type Description

A configuration object to be used when attaching a Compute object.

Exceptions

Type Description

delete

Remove the DatafactoryCompute object from its associated workspace.

delete()

Exceptions

Type Description

Remarks

If this object was created through Azure ML, the corresponding cloud based objects will also be deleted. If this object was created externally and only attached to the workspace, it will raise exception and nothing will be changed.

deserialize

Convert a JSON object into a DataFactoryCompute object.

static deserialize(workspace, object_dict)

Parameters

Name Description
workspace
Required

The workspace object the DataFactoryCompute object is associated with.

object_dict
Required

A JSON object to convert to a DataFactoryCompute object.

Returns

Type Description

The DataFactoryCompute representation of the provided json object.

Exceptions

Type Description

Remarks

Will fail if the provided workspace is not the workspace the Compute is associated with.

detach

Detach the Datafactory object from its associated workspace.

Underlying cloud objects are not deleted, only the association is removed.

detach()

Exceptions

Type Description

provisioning_configuration

Create a configuration object for provisioning a DataFactoryCompute target.

static provisioning_configuration(location=None)

Parameters

Name Description
location
str

The location to provision cluster in. If not specified, will default to workspace location. Available regions for this compute can be found here: https://azure.microsoft.com/global-infrastructure/services/?regions=all&products=data-factory

Default value: None

Returns

Type Description

A configuration object to be used when creating a Compute object.

Exceptions

Type Description

refresh_state

Perform an in-place update of the properties of the object.

This method updates the properties based on the current state of the corresponding cloud object. This is primarily used for manual polling of compute state.

refresh_state()

Exceptions

Type Description

serialize

Convert this DataFactoryCompute object into a JSON serialized dictionary.

serialize()

Returns

Type Description

The JSON representation of this DataFactoryCompute object.

Exceptions

Type Description