Data Flows - Get

Service:: Data Factory

API-versie:: 2018-06-01

Hiermee haalt u een gegevensstroom op.

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	Vereist	Type	Description
dataFlowName	path	True	string minLength: 1 maxLength: 260 pattern: ^[A-Za-z0-9_][^<>#.%&:\\+?/]$	De naam van de gegevensstroom.
factoryName	path	True	string minLength: 3 maxLength: 63 pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$	De naam van de fabriek.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	De naam van de resourcegroep.
subscriptionId	path	True	string	De abonnement-ID.
api-version	query	True	string	De API-versie.

Aanvraagkoptekst

Name	Vereist	Type	Description
If-None-Match		string	ETag van de gegevensstroomentiteit. Mag alleen worden opgegeven voor get. Als de ETag overeenkomt met de bestaande entiteitstag of als * is opgegeven, wordt er geen inhoud geretourneerd.

Antwoorden

Name	Type	Description
200 OK	DataFlowResource	OK.
Other Status Codes	CloudError	Er is een foutbericht ontvangen van de Azure Data Factory-service.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

DataFlows_Get

GET https://management.azure.com/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName/dataflows/exampleDataFlow?api-version=2018-06-01

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.DataFactory.Models;
using Azure.ResourceManager.DataFactory;

// Generated from example definition: specification/datafactory/resource-manager/Microsoft.DataFactory/DataFactory/stable/2018-06-01/examples/DataFlows_Get.json
// this example is just showing the usage of "DataFlows_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this DataFactoryResource created on azure
// for more information of creating DataFactoryResource, please refer to the document of DataFactoryResource
string subscriptionId = "12345678-1234-1234-1234-12345678abc";
string resourceGroupName = "exampleResourceGroup";
string factoryName = "exampleFactoryName";
ResourceIdentifier dataFactoryResourceId = DataFactoryResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, factoryName);
DataFactoryResource dataFactory = client.GetDataFactoryResource(dataFactoryResourceId);

// get the collection of this DataFactoryDataFlowResource
DataFactoryDataFlowCollection collection = dataFactory.GetDataFactoryDataFlows();

// invoke the operation
string dataFlowName = "exampleDataFlow";
NullableResponse<DataFactoryDataFlowResource> response = await collection.GetIfExistsAsync(dataFlowName);
DataFactoryDataFlowResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine("Succeeded with null as result");
}
else
{
    // the variable result is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    DataFactoryDataFlowData resourceData = result.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:: 200

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"
}

Definities

Name	Description
CloudError	Het object dat de structuur van een Azure Data Factory-foutreactie definieert.
DataFlowReference	Verwijzingstype gegevensstroom.
DataFlowReferenceType	Verwijzingstype gegevensstroom.
DataFlowResource	Resourcetype voor gegevensstroom.
DataFlowSink	Transformatie voor sink voor gegevensstromen.
DataFlowSource	Transformatie voor gegevensstroombron.
DatasetReference	Verwijzingstype voor gegevensset.
Flowlet	Gegevensstroomstroomlet
Folder	De map waarin deze gegevensstroom zich bevindt. Als dit niet is opgegeven, wordt de gegevensstroom weergegeven op het hoofdniveau.
LinkedServiceReference	Verwijzingstype voor gekoppelde service.
MappingDataFlow	Toewijzingsgegevensstroom.
PowerQuerySource	Power Query-bron.
Transformation	Een gegevensstroomtransformatie.
Type	Verwijzingstype voor gekoppelde service.
WranglingDataFlow	Power Query-gegevensstroom.

CloudError

Object

Het object dat de structuur van een Azure Data Factory-foutreactie definieert.

Name	Type	Description
error.code	string	Foutcode.
error.details	CloudError[]	Matrix met aanvullende foutdetails.
error.message	string	Foutmelding.
error.target	string	Eigenschapsnaam/pad in aanvraag die is gekoppeld aan een fout.

DataFlowReference

Object

Verwijzingstype gegevensstroom.

Name	Type	Description
datasetParameters	object	Referentiegegevensstroomparameters uit de gegevensset.
parameters	object	Gegevensstroomparameters
referenceName	string	Naam van gegevensstroom verwijzen.
type	DataFlowReferenceType	Verwijzingstype gegevensstroom.

DataFlowReferenceType

Opsomming

Verwijzingstype gegevensstroom.

Waarde	Description
DataFlowReference

DataFlowResource

Object

Resourcetype voor gegevensstroom.

Name	Type	Description
etag	string	Etag identificeert de wijziging in de resource.
id	string	De resource-id.
name	string	De resourcenaam.
properties	DataFlow: Flowlet MappingDataFlow WranglingDataFlow	Eigenschappen van gegevensstroom.
type	string	Het resourcetype.

DataFlowSink

Object

Transformatie voor sink voor gegevensstromen.

Name	Type	Description
dataset	DatasetReference	Naslaginformatie over gegevenssets.
description	string	Beschrijving van transformatie.
flowlet	DataFlowReference	Naslaginformatie voor Flowlet
linkedService	LinkedServiceReference	Naslaginformatie over gekoppelde services.
name	string	Transformatienaam.
rejectedDataLinkedService	LinkedServiceReference	Verwijzing naar gekoppelde gegevensservice geweigerd.
schemaLinkedService	LinkedServiceReference	Naslaginformatie over de gekoppelde schemaservice.

DataFlowSource

Object

Transformatie voor gegevensstroombron.

Name	Type	Description
dataset	DatasetReference	Naslaginformatie over gegevenssets.
description	string	Beschrijving van transformatie.
flowlet	DataFlowReference	Naslaginformatie voor Flowlet
linkedService	LinkedServiceReference	Naslaginformatie over gekoppelde services.
name	string	Transformatienaam.
schemaLinkedService	LinkedServiceReference	Naslaginformatie over de gekoppelde schemaservice.

DatasetReference

Object

Verwijzingstype voor gegevensset.

Name	Type	Description
parameters	object	Argumenten voor gegevensset.
referenceName	string	Naam van referentiegegevensset.
type	enum: DatasetReference	Verwijzingstype voor gegevensset.

Flowlet

Object

Gegevensstroomstroomlet

Name	Type	Description
annotations	object[]	Lijst met tags die kunnen worden gebruikt voor het beschrijven van de gegevensstroom.
description	string	De beschrijving van de gegevensstroom.
folder	Folder	De map waarin deze gegevensstroom zich bevindt. Als dit niet is opgegeven, wordt de gegevensstroom weergegeven op het hoofdniveau.
type	string: Flowlet	Type gegevensstroom.
typeProperties.script	string	Flowlet-script.
typeProperties.scriptLines	string[]	Stroomlet-scriptlijnen.
typeProperties.sinks	DataFlowSink[]	Lijst met sinks in Flowlet.
typeProperties.sources	DataFlowSource[]	Lijst met bronnen in Flowlet.
typeProperties.transformations	Transformation[]	Lijst met transformaties in Flowlet.

Folder

Object

De map waarin deze gegevensstroom zich bevindt. Als dit niet is opgegeven, wordt de gegevensstroom weergegeven op het hoofdniveau.

Name	Type	Description
name	string	De naam van de map waarin deze gegevensstroom zich bevindt.

LinkedServiceReference

Object

Verwijzingstype voor gekoppelde service.

Name	Type	Description
parameters	object	Argumenten voor LinkedService.
referenceName	string	Verwijzing naar de naam van LinkedService.
type	Type	Verwijzingstype voor gekoppelde service.

MappingDataFlow

Object

Toewijzingsgegevensstroom.

Name	Type	Description
annotations	object[]	Lijst met tags die kunnen worden gebruikt voor het beschrijven van de gegevensstroom.
description	string	De beschrijving van de gegevensstroom.
folder	Folder	De map waarin deze gegevensstroom zich bevindt. Als dit niet is opgegeven, wordt de gegevensstroom weergegeven op het hoofdniveau.
type	string: MappingDataFlow	Type gegevensstroom.
typeProperties.script	string	Gegevensstroomscript.
typeProperties.scriptLines	string[]	Scriptregels voor gegevensstromen.
typeProperties.sinks	DataFlowSink[]	Lijst met sinks in gegevensstroom.
typeProperties.sources	DataFlowSource[]	Lijst met bronnen in gegevensstroom.
typeProperties.transformations	Transformation[]	Lijst met transformaties in gegevensstroom.

PowerQuerySource

Object

Power Query-bron.

Name	Type	Description
dataset	DatasetReference	Naslaginformatie over gegevenssets.
description	string	Beschrijving van transformatie.
flowlet	DataFlowReference	Naslaginformatie voor Flowlet
linkedService	LinkedServiceReference	Naslaginformatie over gekoppelde services.
name	string	Transformatienaam.
schemaLinkedService	LinkedServiceReference	Naslaginformatie over de gekoppelde schemaservice.
script	string	bronscript.

Transformation

Object

Een gegevensstroomtransformatie.

Name	Type	Description
dataset	DatasetReference	Naslaginformatie over gegevenssets.
description	string	Beschrijving van transformatie.
flowlet	DataFlowReference	Naslaginformatie voor Flowlet
linkedService	LinkedServiceReference	Naslaginformatie over gekoppelde services.
name	string	Transformatienaam.

Type

Opsomming

Verwijzingstype voor gekoppelde service.

Waarde	Description
LinkedServiceReference

WranglingDataFlow

Object

Power Query-gegevensstroom.

Name	Type	Description
annotations	object[]	Lijst met tags die kunnen worden gebruikt voor het beschrijven van de gegevensstroom.
description	string	De beschrijving van de gegevensstroom.
folder	Folder	De map waarin deze gegevensstroom zich bevindt. Als dit niet is opgegeven, wordt de gegevensstroom weergegeven op het hoofdniveau.
type	string: WranglingDataFlow	Type gegevensstroom.
typeProperties.documentLocale	string	Landinstelling van het Power Query Mashup-document.
typeProperties.script	string	Power Query mashup-script.
typeProperties.sources	PowerQuerySource[]	Lijst met bronnen in Power Query.

Delen via

Data Flows - Get

URI-parameters

Aanvraagkoptekst

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

DataFlows_Get

Voorbeeldaanvraag

Voorbeeldrespons

Definities

CloudError

DataFlowReference

DataFlowReferenceType

DataFlowResource

DataFlowSink

DataFlowSource

DatasetReference

Flowlet

Folder

LinkedServiceReference

MappingDataFlow

PowerQuerySource

Transformation

Type

WranglingDataFlow