Data Flows - Get
Gets a data flow.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/dataflows/{dataFlowName}?api-version=2018-06-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
data
|
path | True |
string |
The data flow name. Regex pattern: |
factory
|
path | True |
string |
The factory name. Regex pattern: |
resource
|
path | True |
string |
The resource group name. Regex pattern: |
subscription
|
path | True |
string |
The subscription identifier. |
api-version
|
query | True |
string |
The API version. |
Request Header
Name | Required | Type | Description |
---|---|---|---|
If-None-Match |
string |
ETag of the data flow entity. Should only be specified for get. If the ETag matches the existing entity tag, or if * was provided, then no content will be returned. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
OK. |
|
Other Status Codes |
An error response received from the Azure Data Factory service. |
Security
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Examples
DataFlows_Get
Sample Request
Sample Response
Date: Mon, 22 Apr 2019 18:33:50 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-reads: 11993
x-ms-request-id: 48983fb5-612a-44c6-8158-add7ffebb32b
x-ms-correlation-request-id: 48983fb5-612a-44c6-8158-add7ffebb32b
{
"id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName/dataflows/exampleDataFlow",
"name": "exampleDataFlow",
"type": "Microsoft.DataFactory/factories/dataflows",
"properties": {
"description": "Sample demo data flow to convert currencies showing usage of union, derive and conditional split transformation.",
"type": "MappingDataFlow",
"typeProperties": {
"sources": [
{
"dataset": {
"referenceName": "CurrencyDatasetUSD",
"type": "DatasetReference"
},
"name": "USDCurrency"
},
{
"dataset": {
"referenceName": "CurrencyDatasetCAD",
"type": "DatasetReference"
},
"name": "CADSource"
}
],
"sinks": [
{
"dataset": {
"referenceName": "USDOutput",
"type": "DatasetReference"
},
"name": "USDSink"
},
{
"dataset": {
"referenceName": "CADOutput",
"type": "DatasetReference"
},
"name": "CADSink"
}
],
"script": "source(output(PreviousConversionRate as double,Country as string,DateTime1 as string,CurrentConversionRate as double),allowSchemaDrift: false,validateSchema: false) ~> USDCurrency\nsource(output(PreviousConversionRate as double,Country as string,DateTime1 as string,CurrentConversionRate as double),allowSchemaDrift: true,validateSchema: false) ~> CADSource\nUSDCurrency, CADSource union(byName: true)~> Union\nUnion derive(NewCurrencyRate = round(CurrentConversionRate*1.25)) ~> NewCurrencyColumn\nNewCurrencyColumn split(Country == 'USD',Country == 'CAD',disjoint: false) ~> ConditionalSplit1@(USD, CAD)\nConditionalSplit1@USD sink(saveMode:'overwrite' ) ~> USDSink\nConditionalSplit1@CAD sink(saveMode:'overwrite' ) ~> CADSink"
}
},
"etag": "15004c4f-0000-0200-0000-5cbe090e0000"
}
Definitions
Name | Description |
---|---|
Cloud |
The object that defines the structure of an Azure Data Factory error response. |
Data |
Data flow reference type. |
Data |
Data flow reference type. |
Data |
Data flow resource type. |
Data |
Transformation for data flow sink. |
Data |
Transformation for data flow source. |
Dataset |
Dataset reference type. |
Flowlet |
Data flow flowlet |
Folder |
The folder that this data flow is in. If not specified, Data flow will appear at the root level. |
Linked |
Linked service reference type. |
Mapping |
Mapping data flow. |
Power |
Power query source. |
Transformation |
A data flow transformation. |
Type |
Linked service reference type. |
Wrangling |
Power Query data flow. |
CloudError
The object that defines the structure of an Azure Data Factory error response.
Name | Type | Description |
---|---|---|
error.code |
string |
Error code. |
error.details |
Array with additional error details. |
|
error.message |
string |
Error message. |
error.target |
string |
Property name/path in request associated with error. |
DataFlowReference
Data flow reference type.
Name | Type | Description |
---|---|---|
datasetParameters |
object |
Reference data flow parameters from dataset. |
parameters |
object |
Data flow parameters |
referenceName |
string |
Reference data flow name. |
type |
Data flow reference type. |
DataFlowReferenceType
Data flow reference type.
Name | Type | Description |
---|---|---|
DataFlowReference |
string |
DataFlowResource
Data flow resource type.
Name | Type | Description |
---|---|---|
etag |
string |
Etag identifies change in the resource. |
id |
string |
The resource identifier. |
name |
string |
The resource name. |
properties | DataFlow: |
Data flow properties. |
type |
string |
The resource type. |
DataFlowSink
Transformation for data flow sink.
Name | Type | Description |
---|---|---|
dataset |
Dataset reference. |
|
description |
string |
Transformation description. |
flowlet |
Flowlet Reference |
|
linkedService |
Linked service reference. |
|
name |
string |
Transformation name. |
rejectedDataLinkedService |
Rejected data linked service reference. |
|
schemaLinkedService |
Schema linked service reference. |
DataFlowSource
Transformation for data flow source.
Name | Type | Description |
---|---|---|
dataset |
Dataset reference. |
|
description |
string |
Transformation description. |
flowlet |
Flowlet Reference |
|
linkedService |
Linked service reference. |
|
name |
string |
Transformation name. |
schemaLinkedService |
Schema linked service reference. |
DatasetReference
Dataset reference type.
Name | Type | Description |
---|---|---|
parameters |
object |
Arguments for dataset. |
referenceName |
string |
Reference dataset name. |
type | enum: |
Dataset reference type. |
Flowlet
Data flow flowlet
Name | Type | Description |
---|---|---|
annotations |
object[] |
List of tags that can be used for describing the data flow. |
description |
string |
The description of the data flow. |
folder |
The folder that this data flow is in. If not specified, Data flow will appear at the root level. |
|
type | string: |
Type of data flow. |
typeProperties.script |
string |
Flowlet script. |
typeProperties.scriptLines |
string[] |
Flowlet script lines. |
typeProperties.sinks |
List of sinks in Flowlet. |
|
typeProperties.sources |
List of sources in Flowlet. |
|
typeProperties.transformations |
List of transformations in Flowlet. |
Folder
The folder that this data flow is in. If not specified, Data flow will appear at the root level.
Name | Type | Description |
---|---|---|
name |
string |
The name of the folder that this data flow is in. |
LinkedServiceReference
Linked service reference type.
Name | Type | Description |
---|---|---|
parameters |
object |
Arguments for LinkedService. |
referenceName |
string |
Reference LinkedService name. |
type |
Linked service reference type. |
MappingDataFlow
Mapping data flow.
Name | Type | Description |
---|---|---|
annotations |
object[] |
List of tags that can be used for describing the data flow. |
description |
string |
The description of the data flow. |
folder |
The folder that this data flow is in. If not specified, Data flow will appear at the root level. |
|
type | string: |
Type of data flow. |
typeProperties.script |
string |
DataFlow script. |
typeProperties.scriptLines |
string[] |
Data flow script lines. |
typeProperties.sinks |
List of sinks in data flow. |
|
typeProperties.sources |
List of sources in data flow. |
|
typeProperties.transformations |
List of transformations in data flow. |
PowerQuerySource
Power query source.
Name | Type | Description |
---|---|---|
dataset |
Dataset reference. |
|
description |
string |
Transformation description. |
flowlet |
Flowlet Reference |
|
linkedService |
Linked service reference. |
|
name |
string |
Transformation name. |
schemaLinkedService |
Schema linked service reference. |
|
script |
string |
source script. |
Transformation
A data flow transformation.
Name | Type | Description |
---|---|---|
dataset |
Dataset reference. |
|
description |
string |
Transformation description. |
flowlet |
Flowlet Reference |
|
linkedService |
Linked service reference. |
|
name |
string |
Transformation name. |
Type
Linked service reference type.
Name | Type | Description |
---|---|---|
LinkedServiceReference |
string |
WranglingDataFlow
Power Query data flow.
Name | Type | Description |
---|---|---|
annotations |
object[] |
List of tags that can be used for describing the data flow. |
description |
string |
The description of the data flow. |
folder |
The folder that this data flow is in. If not specified, Data flow will appear at the root level. |
|
type | string: |
Type of data flow. |
typeProperties.documentLocale |
string |
Locale of the Power query mashup document. |
typeProperties.script |
string |
Power query mashup script. |
typeProperties.sources |
List of sources in Power Query. |