De Functions-activiteit gebruiken om functies voor gebruikersgegevens van Fabric of Azure Functions uit te voeren

Met de Functions-activiteit in Data Factory voor Microsoft Fabric kunt u aangepaste code uitvoeren als onderdeel van uw gegevenspijplijn. Wanneer u een Functions-activiteit toevoegt, kiest u welk type functie u wilt uitvoeren:

• Fabric-functies voor gebruikersgegevens: Herbruikbare Python-functies die u in Microsoft Fabric maakt en beheert. Gebruik fabric-gebruikersgegevensfuncties als u bedrijfslogica wilt centraliseren die kan worden aangeroepen vanuit pijplijnen, notebooks, Activator-regels of externe toepassingen. Functies voor gebruikersgegevens zijn ideaal voor gegevenstransformaties, validatieregels en bedrijfslogica die consistent moeten zijn in uw Infrastructuurworkloads.

• Azure Functions: Serverloze functies die worden gehost in Azure. Gebruik Azure Functions wanneer u mogelijkheden nodig hebt die verder gaan dan de functies van Fabric-gebruikersgegevens, zoals verschillende taalruntimes of integratie met Azure-services buiten Fabric.

In dit artikel wordt beschreven hoe u een Functions-activiteit toevoegt aan een pijplijn en deze configureert voor beide typen functies.

Vereiste voorwaarden

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

• Een tenantaccount met een actief abonnement. Gratis een account maken
• Er wordt een werkruimte gemaakt.

Een Functions-activiteit toevoegen aan een pijplijn

De stappen in deze sectie zijn van toepassing of u de activiteit configureert om Fabric-gebruikersgegevensfuncties of Azure Functions uit te voeren. Nadat u de activiteit hebt toegevoegd en algemene instellingen hebt geconfigureerd, kiest u welk type functie u wilt uitvoeren.

Ga als volgende te werk om een Functions-activiteit toe te voegen aan uw pijplijn:

1. Selecteer in uw werkruimte + Nieuw item.

2. Zoek in het dialoogvenster Nieuw item naar Pijplijn en selecteer het.

3. Voer in het dialoogvenster Nieuwe pijplijn een naam in voor de pijplijn en selecteer Maken.

4. Selecteer op de startpagina van de pijplijn het tabblad Activiteiten .

5. Selecteer op het lint Activiteiten het pictogram ... (beletselteken) om meer activiteiten weer te geven.

6. Zoek naar Functies in de lijst met activiteiten onder Orchestrate en selecteer deze om de functieactiviteit toe te voegen aan het pijplijncanvas.

   

Algemene instellingen configureren

De algemene instellingen zijn van toepassing op zowel fabric-gebruikersgegevensfuncties als Azure Functions-activiteiten.

1. Selecteer de Functions-activiteit op het canvas van de pijplijneditor als deze nog niet is geselecteerd.

2. Selecteer het tabblad Algemeen .

   

3. Voer een naam in voor de activiteit.

4. Configureer eventueel instellingen voor opnieuw proberen en geef op of u beveiligde invoer of uitvoer doorgeeft.

Zie de richtlijnen voor algemene instellingen voor meer informatie.

De activiteit voor gebruikersgegevensfuncties configureren

Als u fabric-gebruikersgegevensfuncties wilt uitvoeren, configureert u de activiteitsinstellingen als volgt:

1. Selecteer het tabblad Instellingen.

2. Selecteer Fabric-gebruikersgegevensfuncties als het type.

   

3. Selecteer in de vervolgkeuzelijst Verbinding een verbinding die u wilt gebruiken. Als u de gewenste verbinding niet ziet, selecteert u Alles bladeren.

4. Zoek in het dialoogvenster Een gegevensbron kiezen om aan de slag te gaan naar functies voor gebruikersgegevens en selecteer deze. De lijst wordt weergegeven onder Nieuwe bronnen.

5. In het dialoogvenster Verbinding maken met gegevensbron kunt u de standaardverbindingsnaam en -referenties behouden. Zorg ervoor dat u bent aangemeld en selecteer Verbinding maken.

   Notitie

   Als u al een verbinding hebt, wordt deze mogelijk vooraf geselecteerd in het dialoogvenster. U kunt de bestaande verbinding behouden of een nieuwe verbinding maken selecteren in de vervolgkeuzelijst om een nieuwe verbinding te maken.

6. Selecteer UserDataFunctions in de vervolgkeuzelijst Verbinding in de activiteitsinstellingen. Deze verbinding is de verbinding die u zojuist hebt gemaakt.

7. Selecteer de werkruimte met het functie-item voor gebruikersgegevens.

8. Selecteer de itemnaam van de gebruikersgegevensfuncties .

9. Selecteer de functie die u wilt aanroepen.

10. Geef invoerparameters op voor de geselecteerde functie. U kunt statische waarden of dynamische inhoud uit pijplijnexpressies gebruiken.

Zie Activiteit voor het maken en uitvoeren van gebruikersgegevensfuncties in pijplijnen voor meer informatie over het maken en uitvoeren van functies voor gebruikersgegevens in pijplijnen in de documentatie voor data engineering.

De activiteit voor Azure Functions configureren

In plaats van Fabric-functies voor gebruikersgegevens te kiezen, kunt u de Azure-functie kiezen als het type om Azure Functions uit te voeren vanuit uw pijplijn.

De activiteit voor Azure Functions configureren:

1. Selecteer het tabblad Instellingen.

2. Selecteer de Azure-functie als het type.

   

3. Selecteer een bestaande Azure Function-verbinding of maak een nieuwe.

4. Geef een relatieve FUNCTIE-URL op die verwijst naar het relatieve pad naar de Azure App-functie binnen de Azure Function-verbinding.

5. Selecteer een HTTP-methode die moet worden verzonden naar de URL.

6. Geef desgewenst extra headers op als vereist voor de functie die u uitvoert.

Een on-premises of virtuele netwerkgegevensgateway gebruiken voor Azure Functions

Als uw Azure Function-app wordt beveiligd achter een firewall of een particulier netwerk, kunt u een gegevensgateway gebruiken om een beveiligde verbinding tot stand te brengen. Gegevensgateways fungeren als een brug tussen Fabric en resources die niet openbaar toegankelijk zijn.

• On-premises gegevensgateway (OPDG): geïnstalleerd op een server in uw netwerk. Hiermee kan Fabric verbinding maken met uw Azure Functions via een beveiligd kanaal zonder binnenkomende poorten te openen.
• VNET-gegevensgateway (virtueel netwerk): een beheerde service die verbinding maakt met Azure-resources binnen een virtueel netwerk, zonder dat er een on-premises installatie is vereist.

Voor begeleiding bij het creëren en configureren van uw OPDG, zie On-premises gegevensgateway maken. Als u een VNET-gateway wilt gebruiken, raadpleegt u Een VNET-gegevensgateway maken.

Nadat u de gateway hebt gemaakt en geconfigureerd, wordt deze weergegeven in de vervolgkeuzelijst Data Gateway in het dialoogvenster Verbinding met Azure Function.

Sla op en voer de pijplijn uit of plan deze in.

Nadat u de Functions-activiteit en eventuele andere activiteiten voor uw pijplijn hebt geconfigureerd:

1. Selecteer het tabblad Start boven aan de pijplijneditor.

2. Selecteer Opslaan om uw pijplijn op te slaan.

   

3. Selecteer Uitvoeren om de pijplijn onmiddellijk uit te voeren of selecteer Planning om een terugkerend schema in te stellen.

Nadat u de pijplijn heeft uitgevoerd, kunt u de pijplijnuitvoering bewaken en de uitvoeringsgeschiedenis bekijken op het Uitvoer tabblad onder het canvas.

Gerelateerde inhoud

• Overzicht van activiteit
• Hoe je pijplijnuitvoeringen bewaakt
• Functies voor gebruikersgegevens maken en uitvoeren in pijplijnen