Del via

Brug webaktiviteten til at kalde REST API'er i pipelines

Webaktivitet kan bruges til at kalde et brugerdefineret REST-slutpunkt fra en Azure Data Factory- eller Synapse-pipeline. Du kan overføre datasæt og tilknyttede tjenester, der skal forbruges og tilgås af aktiviteten.

Bemærk

Den maksimale understøttede nyttedatastørrelse for outputsvar er 4 MB.

Forudsætninger

For at komme i gang skal du fuldføre følgende forudsætninger:

Føj en webaktivitet til en pipeline med brugergrænsefladen

Hvis du vil bruge en webaktivitet i en pipeline, skal du udføre følgende trin:

Opret aktiviteten

  1. Opret en ny pipeline i dit arbejdsområde.

  2. Søg efter web i ruden pipelineaktiviteter, og vælg det for at føje det til pipelinelærredet.

    Skærmbillede af brugergrænsefladen i Fabric, hvor ruden Aktiviteter og webaktivitet er fremhævet.

  3. Vælg den nye webaktivitet på lærredet, hvis den ikke allerede er valgt.

    Skærmbillede, der viser fanen Generelle indstillinger for webaktiviteten.

    Bemærk

    Webaktiviteten kan vises som et ikon på værktøjslinjen som vist på det forrige billede, hvis skærmopløsningen ikke tillader, at navnet er fuldt stavet.

Se vejledningen til generelle indstillinger for at konfigurere fanen Generelle indstillinger.

Indstillinger for webaktivitet

  1. Vælg fanen Indstillinger , vælg en eksisterende forbindelse på rullelisten Forbindelse , eller opret en ny forbindelse, og angiv konfigurationsoplysningerne.

    Skærmbillede, der viser fanen Indstillinger for opslagsaktivitet, der fremhæver fanen, og hvor du kan vælge en ny forbindelse.

  2. Når du vælger + Ny for at oprette en ny forbindelse, kan du se dialogboksen til oprettelse af forbindelse, hvor du kan angive den grundlæggende URL-adresse og de legitimationsoplysninger, der skal oprettes forbindelse til.

    Skærmbillede, der viser dialogboksen ny forbindelse for webaktiviteten.

    Bemærk

    Forbindelsesnavnet må højst være 80 tegn langt.

Brug af on-premises eller virtuel netværksdatagateway

  1. Når du opretter din forbindelse, kan du nu vælge at bruge enten en on-premises datagateway (OPDG) eller en virtuel netværksdatagateway. Du kan finde en vejledning i, hvordan du opretter og konfigurerer din OPDG, under Sådan opretter du datagateway i det lokale miljø

  2. Hvis du ønsker at bruge en virtuel netværksgateway, kan du se på, hvordan du opretter en virtuel netværksdatagateway.

  3. Når du har oprettet og konfigureret din gateway, vises den under rullelisten Datagateway i forbindelsesdialogboksen

    Skærmbillede, der viser dialogboksen for forbindelse til datagatewayen for webaktiviteten.

  4. Når du har valgt eller oprettet din forbindelse og datagateway, skal du udfylde de resterende obligatoriske felter, tilføje eventuelle påkrævede overskrifter eller angive avancerede indstillinger. Webaktiviteten understøtter metoderne GET, POST, PUT, DELETE og PATCH.

  5. Når du har valgt eller oprettet din forbindelse, skal du udfylde de resterende obligatoriske felter, tilføje eventuelle påkrævede overskrifter eller angive avancerede indstillinger. Webaktiviteten understøtter metoderne GET, POST, PUT, DELETE og PATCH.

Gem og kør eller planlæg pipelinen

Du bruger typisk outputtet fra webaktiviteten sammen med andre aktiviteter, men når den er konfigureret, kan den også køres direkte uden andre aktiviteter. Hvis du kører den for at aktivere en REST-API, der udfører en handling og ikke kræver noget output fra aktiviteten, indeholder pipelinen muligvis også kun webaktiviteten.

Skift til fanen Hjem øverst i pipeline-editoren og vælg gem-knappen for at gemme din pipeline. Vælg Kør for at køre direkte eller Skemalæg for at planlægge løb på bestemte tidspunkter eller intervaller. For mere information om rørledningskørsler, se: planlæg rørledningskørsler.

Skærmbillede, der viser fanen Hjem i pipelineeditoren med tabulatornavnet, knapperne Gem, Kør og Planlæg fremhævet.

Efter kørsel kan du overvåge pipeline-udførelsen og se kørselshistorik fra fanen Output under lærredet.

Relateret indhold

  • Last updated on