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-automatisering. U kunt gegevenssets en gekoppelde services doorgeven die moten worden verbruikt door en die toegankelijk zijn voor de activiteit.

Notitie

De maximale grootte van de ondersteunde nettolading van het uitvoerantwoord is 4 MB.

Vereisten

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

Een webactiviteit toevoegen aan een pijplijn met 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 internet in het deelvenster Activiteiten van de pijplijn en selecteer het om het toe te voegen aan het pijplijncanvas.

    Schermopname van de infrastructuurgebruikersinterface 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.

  3. 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 en uitvoeren of plannen

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.