Delen via


De webactiviteit gebruiken om REST API's aan te roepen in pijplijnen

De Webactiviteit kan worden gebruikt om een aangepast REST-eindpunt aan te roepen vanaf een Azure Data Factory- of Synapse-pipeline. U kunt gegevenssets en gekoppelde services doorgeven zodat deze worden geconsumeerd en toegankelijk zijn voor de activiteit.

Notitie

De maximale ondersteunde payloadgrootte van de uitvoer is 4 MB.

Vereisten

Om aan de slag te gaan, moet u aan de volgende vereisten voldoen:

Een webactiviteit toevoegen aan een pijplijn met de UI

Voer de volgende stappen uit om een webactiviteit in een pijplijn te gebruiken:

De activiteit maken

  1. Maak een nieuwe pijplijn in uw werkruimte.

  2. Zoek naar Web in het Activiteiten-deelvenster van de pijplijn en selecteer het om het aan het pijplijncanvas toe te voegen.

    Schermopname van de Fabric UI met het deelvenster Activiteiten en Webactiviteit gemarkeerd.

  3. Selecteer de nieuwe webactiviteit op het canvas als deze nog niet is geselecteerd.

    Schermopname van het tabblad Algemene instellingen van de webactiviteit.

    Notitie

    De webactiviteit kan gewoon worden weergegeven als een pictogram op de werkbalk, zoals wordt weergegeven in de vorige afbeelding, als de schermresolutie niet toestaat dat de naam volledig wordt gespeld.

Raadpleeg de richtlijnen voor algemene instellingen voor het configureren van het tabblad Algemene instellingen.

Instellingen voor webactiviteit

  1. Selecteer het tabblad Instellingen , selecteer een bestaande verbinding in de vervolgkeuzelijst Verbinding of maak een nieuwe verbinding en geef de configuratiegegevens op.

    Schermopname van het tabblad Activiteitsinstellingen opzoeken waarin het tabblad wordt gemarkeerd en waar u een nieuwe verbinding kunt kiezen.

  2. Wanneer u + Nieuw kiest om een nieuwe verbinding te maken, ziet u het dialoogvenster voor het maken van de verbinding, waar u de basis-URL en referenties kunt opgeven om verbinding te maken.

    Schermopname van het dialoogvenster Nieuwe verbinding voor de webactiviteit.

    Notitie

    De verbindingsnaam mag maximaal 80 tekens lang zijn.

On-premises of VNET-gegevensgateway gebruiken

  1. Wanneer u uw verbinding maakt, kunt u er nu voor kiezen om een on-premises gegevensgateway (OPDG) of een VNET-gegevensgateway te gebruiken. Raadpleeg voor hulp bij het maken en configureren van uw OPDG hoe u een on-premises gegevensgateway maakt

  2. Als u een VNET-gateway wilt gebruiken, raadpleegt u hoe u een VNET-gegevensgateway maakt.

  3. Zodra u de gateway hebt gemaakt en geconfigureerd, wordt deze weergegeven onder de vervolgkeuzelijst Gegevensgateway in het verbindingsdialoogvenster

    Schermopname van het dialoogvenster gegevensgatewayverbinding voor de webactiviteit.

  4. Nadat u de verbinding en gegevensgateway hebt gekozen of gemaakt, moet u de resterende vereiste velden voltooien, eventuele vereiste headers toevoegen of geavanceerde instellingen instellen. De webactiviteit ondersteunt GET-, POST-, PUT-, DELETE- en PATCH-methoden.

  5. Nadat u de verbinding hebt gekozen of gemaakt, moet u de resterende vereiste velden voltooien, eventuele vereiste headers toevoegen of geavanceerde instellingen instellen. De webactiviteit ondersteunt GET-, POST-, PUT-, DELETE- en PATCH-methoden.

De pijplijn opslaan, uitvoeren of inplannen

Normaal gesproken gebruikt u de uitvoer van de webactiviteit met andere activiteiten, maar zodra deze is geconfigureerd, kan deze ook rechtstreeks worden uitgevoerd zonder andere activiteiten. Als u deze uitvoert om een REST API aan te roepen die een bepaalde actie uitvoert en geen uitvoer van de activiteit vereist, bevat uw pijplijn mogelijk ook alleen de webactiviteit. Als u de activiteit wilt uitvoeren, gaat u naar het tabblad Start boven aan de pijplijneditor en selecteert u de knop Opslaan om uw pijplijn op te slaan. Selecteer Uitvoeren om het rechtstreeks uit te voeren of Plan om deze te plannen. U kunt hier ook de uitvoeringsgeschiedenis bekijken of andere instellingen configureren.

Schermopname van het tabblad Start in de pijplijneditor met de tabnaam, de knoppen Opslaan, Uitvoeren en Planning gemarkeerd.