Del via

Brug Functions-aktiviteten til at køre Fabric-brugerdatafunktioner eller Azure Functions

Funktionen-aktiviteten i Data Factory for Microsoft Fabric giver dig mulighed for at køre brugerdefineret kode som en del af din datapipeline. Når du tilføjer en Functions-aktivitet, vælger du, hvilken type funktion der skal køres:

  • Fabric brugerdatafunktioner: Genanvendelige Python-funktioner, som du opretter og administrerer inden for Microsoft Fabric. Brug Fabric-brugerdatafunktioner, når du vil centralisere forretningslogik, der kan kaldes fra pipelines, notebooks, Activator-regler eller eksterne applikationer. Brugerdatafunktioner er ideelle til datatransformationer, valideringsregler og forretningslogik, der skal være konsistent på tværs af dine Fabric-arbejdsbelastninger.

  • Azure Functions: Serverløse funktioner hostet i Azure. Brug Azure Functions, når du har brug for funktioner ud over det, Fabric-brugerdatafunktioner tilbyder, såsom forskellige sprogruntimes eller integration med Azure-tjenester uden for Fabric.

Denne artikel viser dig, hvordan du tilføjer en Functions-aktivitet til en pipeline og konfigurerer den til begge typer funktioner.

Forudsætninger

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

Tilføj en Functions-aktivitet til en pipeline

Trinene i dette afsnit gælder, uanset om du konfigurerer aktiviteten til at køre Fabric brugerdatafunktioner eller Azure Functions. Efter du har tilføjet aktiviteten og konfigureret generelle indstillinger, vælger du, hvilken type funktion der skal køres.

For at tilføje en Functions-aktivitet til din pipeline:

  1. Vælg + Nyt elementi dit arbejdsområde.

  2. I dialogen Nyt element søger du efter Pipeline og vælger den.

  3. I dialogen Ny pipeline indtaster du et navn for pipelinen og vælger Create.

  4. På pipeline-hjemmesiden skal du vælge fanen Aktiviteter .

  5. I Aktiviteter-båndet skal du vælge ... (ellipsis) ikonet for at se flere aktiviteter.

  6. Søg efter Functions i listen over aktiviteter under Orchestrate, og vælg den derefter for at tilføje Functions-aktiviteten til pipeline-lærredet.

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

Konfigurer generelle indstillinger

De generelle indstillinger gælder både for Fabric-brugerdatafunktioner og Azure Functions-aktiviteter.

  1. Vælg Funktioner-aktiviteten på pipeline-editorens lærred, hvis den ikke allerede er valgt.

  2. Vælg fanen Generelt.

    Skærmbillede, der viser fanen Generelle indstillinger i aktiviteten Functions.

  3. Indtast et navn til aktiviteten.

  4. Eventuelt kan du konfigurere indstillinger for forsøg igen og angive, om du sender sikkert input eller output.

For mere information, se vejledningen til generelle indstillinger .

Konfigurer aktiviteten for brugerdatafunktioner

For at køre Fabric-brugerdatafunktioner, konfigurer aktivitetsindstillingerne som følger:

  1. Vælg fanen Indstillinger.

  2. Select Fabric-brugerdata fungerer som Type.

    Skærmbillede, der viser fanen Indstillinger for aktiviteten Fabric-brugerdatafunktioner.

  3. I dropdowndown-menuen Forbindelse skal du vælge en forbindelse, du vil bruge. Hvis du ikke kan se den forbindelse, du ønsker, vælg Gennemse alle.

  4. I dialogen Vælg en datakilde for at komme i gang , søg efter User Data Functions og vælg den. Du burde se det opført under Nye kilder.

  5. I dialogen Connect til datakilde kan du beholde standardforbindelsesnavnet og legitimationsoplysningerne. Sørg for, at du er logget ind, og vælg derefter Forbind.

    Bemærk

    Hvis du allerede har en forbindelse, kan den være forudvalgt i dialogen. Du kan beholde den eksisterende forbindelse eller vælge Opret ny forbindelse fra dropdownmenuen for at oprette en ny.

  6. Tilbage i aktivitetsindstillingerne og vælg UserDataFunctions fra Forbindelsesmenuen . Denne forbindelse er den forbindelse, du lige har skabt.

  7. Vælg elementet Workspace , der indeholder dine brugerdatafunktioner.

  8. Vælg Brugerdatafunktionen itemnavn.

  9. Vælg den funktion , du vil aktivere.

  10. Angiv inputparametre for din valgte funktion. Du kan bruge statiske værdier eller dynamisk indhold fra pipeline-udtryk.

Tips

For at indtaste dynamisk indhold skal du vælge det felt, du vil udfylde, og derefter trykke Alt+Shift+D for at åbne udtryksbyggeren.

For mere information om oprettelse og drift af brugerdatafunktioner i pipelines, se Skab og kør user datafunktioner aktivitet i pipelines i Data Engineering-dokumentationen.

Konfigurér aktiviteten for Azure Functions

I stedet for at vælge Fabric-brugerdatafunktioner kan du vælge Azure-funktionen som typen til at køre Azure Functions fra din pipeline.

For at konfigurere aktiviteten for Azure Functions:

  1. Vælg fanen Indstillinger.

  2. Vælg Azure-funktionen som Type.

    Skærmbillede, der viser fanen Indstillinger i Azure Function-aktiviteten.

  3. Vælg en eksisterende Azure Function-forbindelse eller opret en ny.

  4. Giv en Function relative URL , der peger på den relative sti til Azure App-funktionen inden for Azure Function-forbindelsen.

  5. Vælg en HTTP-metode, der skal sendes til URL'en.

  6. Eventuelt kan du specificere ekstra Headers efter behov for den funktion, du udfører.

Brug en on-premises eller virtuel netværksdatagateway til Azure Functions

Hvis din Azure Function App er sikret bag en firewall eller privat netværk, kan du bruge en datagateway til at etablere en sikker forbindelse. Datagateways fungerer som en bro mellem Fabric og ressourcer, der ikke er offentligt tilgængelige:

  • On-premises datagateway (OPDG): Installeret på en server inden for dit netværk. Det gør det muligt for Fabric at forbinde til dine Azure Functions via en sikker kanal uden at åbne indgående porte.
  • Virtuelt netværk (VNET) datagateway: En administreret tjeneste, der forbinder til Azure-ressourcer inden for et virtuelt netværk uden at kræve en lokal installation.

Bemærk

Understøttelse af datagateway er kun tilgængelig for Azure Functions. Fabric-brugerdatafunktioner understøtter i øjeblikket ikke on-premises eller VNET-datagateways.

For vejledning i oprettelse og konfiguration af din OPDG, se Sådan opretter du on-premises datagateway. Hvis du vil bruge en VNET-gateway, se Sådan opretter du en VNET-datagateway.

Når du har oprettet og konfigureret din gateway, vises den under Data Gateway-dropdownmenuen i Azure Function forbindelsesdialogen.

Skærmbillede, der viser dialogboksen for datagatewayens forbindelse for Azure-funktionsaktiviteten.

Gem og kør eller planlæg pipelinen

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