Een Fabric User Data Functions-item maken

In deze handleiding maken we een nieuw item User Data Functions en schrijven we er nieuwe functies in. Elk item User Data Functions bevat code waarmee een of meer functies worden gedefinieerd die u afzonderlijk kunt uitvoeren.

U leert met name het volgende:

• Maak een functie-item voor gebruikersgegevens.
• Een nieuwe functie schrijven.
• Functies beheren.
• Voer uw functie uit.

Vereiste voorwaarden

• Een Microsoft Fabric-capaciteit in een van de ondersteunde regio's. Als u geen Fabric-capaciteit hebt, kunt u gratis een proefcapaciteit maken.
• Een Infrastructuurwerkruimte die is gekoppeld aan die capaciteit

Een nieuw item in Fabric User Data Functions maken

1. Selecteer uw werkruimte en selecteer + Nieuw item.
2. Selecteer Itemtype als Alle items. Zoek en selecteer functies voor gebruikersgegevens.

Een nieuw item voor gebruikersgegevensfuncties maken

1. Selecteer in uw werkruimte + Nieuw item.

2. Zoek in het deelvenster dat wordt geopend naar user data functionsen selecteer vervolgens de tegel.

   

3. Geef een naam op voor het item gebruikersgegevensfuncties.

4. Selecteer nieuwe functie om een hello_fabric Python-functiesjabloon te maken. In Functions Explorer worden alle functies weergegeven die zijn gepubliceerd en die gereed zijn om te worden aangeroepen.

   

5. Zodra de hello_fabric functie is gepubliceerd, kunt u deze uitvoeren vanuit de lijst met functies in Functions Explorer.

   

Een nieuwe functie toevoegen vanuit een voorbeeld

Dit is een voorbeeld van het toevoegen van een nieuwe functie vanuit het menu Insert sample. In dit geval voegen we een functie toe met de naam Gegevens bewerken met pandas-bibliotheek die de pandas-bibliotheek als vereiste gebruikt. Volg de stappen om deze voorbeeldfunctie toe te voegen:

1. Zorg ervoor dat u zich in de ontwikkelmodus bevindt. Selecteer Bibliotheekbeheer om de bibliotheken toe te voegen die uw functie nodig heeft.

   

   Notitie

   fabric_user_data_functions bibliotheek is standaard toegevoegd en kan niet worden verwijderd. Deze bibliotheek is vereist voor de functionaliteit van gebruikersgegevensfuncties. U moet de versie van deze bibliotheek bijwerken voor toekomstige versies van deze SDK.

2. Selecteer pandas-bibliotheek en selecteer de versie. Zodra de bibliotheek is toegevoegd, wordt deze automatisch opgeslagen in het item User Data Functions.

   

3. Selecteer Voorbeeld invoegen en selecteer Gegevens bewerken met pandas-bibliotheek. Met deze actie wordt voorbeeldcode onder aan uw code ingevoegd, na de andere functies.

   

4. Zodra het voorbeeld in de editor is ingevoegd, test u het met behulp van de testfunctie in de ontwikkelmodus.

5. Wanneer u klaar bent, kunt u Publiceren selecteren om uw wijzigingen op te slaan en uw functies bij te werken. Het publiceren kan enkele minuten duren.

   

6. Nadat het publiceren is voltooid, ziet u de nieuwe functie in de functiesverkennerlijst. Deze functie kan nu worden uitgevoerd vanuit de portal of worden aangeroepen vanuit een andere toepassing of infrastructuuritem, zoals een pijplijn.

   

Uw functie uitvoeren

1. Als u uw functie wilt uitvoeren, moet u eerst overschakelen naar de modus Alleen uitvoeren door op de modusschakelaar te klikken.

   

2. Selecteer het pictogram Uitvoeren dat wordt weergegeven wanneer u de muisaanwijzer boven een functie in de Functieverkenner-lijst beweegt.

   

3. Geef de vereiste parameters door in de Functieverkenner als een formulier. In dit geval gaan we de manipulate_data-functie uitvoeren waarvoor een JSON-tekenreeks als parameter is vereist.

   [
    {
     "Name": "John",
     "Age": 22,
     "Gender": "male"
    }
   ]
   

4. Selecteer uitvoeren om de functie uit te voeren.

   

5. U kunt de livelogboeken en de uitvoer voor de functie zien om te controleren of deze is uitgevoerd. U ziet ook een foutbericht en logboeken van uw functieaanroep.

Een nieuwe functie schrijven

Elke runnable functie begint met een @udf.function() decorator vóór de functiedefinitie. Lees meer over ons Python Programming-model. Als u een nieuwe functie wilt schrijven, gebruikt u de decorator @udf.function() aan het begin om deze als een uitvoerbare functie te declareren. Hier volgt een voorbeeldfunctie:

# This sample allows you to pass a credit card number as an integer and mask it, leaving the last 4 digits. 

@udf.function()
def maskCreditCard(cardNumber: int)-> str:
    # Convert the card number to a string
    cardNumberStr = str(cardNumber)
    
    # Check if the card number is valid
    if not cardNumberStr.isdigit() or not (13 <= len(cardNumberStr) <= 19):
        raise ValueError("Invalid credit card number")
    
    # Mask all but the last four digits
    maskedNumber = '*' * (len(cardNumberStr) - 4) + cardNumberStr[-4:]
    
    return str(maskedNumber)

Zodra de functie gereed is, publiceert u de functie om deze uit te voeren.

Belangrijkste concepten van programmeermodel

Uw gebruikersgegevensfuncties gebruiken het Python-programmeermodel User Data Functions om afzonderlijke functies te maken, uit te voeren, fouten op te sporen en te wijzigen. Dit is een bibliotheek van derden die de benodigde functionaliteit biedt om uw functies in Fabric aan te roepen en gebruik te maken van alle integraties.

Nadat u uw eerste functie hebt gemaakt, bevatten de eerste regels van de code de importinstructies met de benodigde bibliotheken om uw sjabloon uit te voeren.

import datetime
import fabric.functions as fn
import logging

udf = fn.UserDataFunctions()

Notitie

De importverklaring met de fabric.functions-bibliotheek en de regel met deze verklaring udf = fn.UserDataFunctions() zijn nodig om uw functies correct uit te voeren. Uw -functies werken niet goed als deze regels ontbreken.

• Als u functies wilt maken, uitvoeren, beheren, hebt u fabric.functions SDK en enkele andere belangrijke bibliotheken nodig, zoals logging kunt u aangepaste logboeken schrijven.
• udf=fn.UserDataFunctions() is de constructie voor het definiëren van functies binnen een item gebruikersgegevensfuncties.

Gegevensfuncties beheren

De naam van een functie wijzigen

1. Selecteer in de ontwikkelmodus de code-editor en werk de naam van de functie bij. Wijzig bijvoorbeeld de naam in hello_fabrichello_fabric1:

   @udf.function()
   def hello_fabric1(name: str) -> str:
      logging.info('Python UDF trigger function processed a request.')
   
      return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!"
   

2. Nadat u de naam hebt gewijzigd, selecteert u Publish om deze wijzigingen op te slaan.

3. Zodra de wijzigingen zijn gepubliceerd, kunt u de nieuwe naam voor de functie weergeven in De Functieverkenner.

Een functie verwijderen

Als u een functie wilt verwijderen, selecteert u functiecode in de code-editor en verwijdert u de hele codesectie. Publiceer de wijzigingen om deze volledig te verwijderen uit het item met gebruikersgegevensfuncties.

Als u bijvoorbeeld de functie hello_fabric wilt verwijderen, verwijdert u het volgende codeblok:

@udf.function()
def hello_fabric(name: str) -> str:
    logging.info('Python UDF trigger function processed a request.')

    return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!"

Nadat de code is verwijderd, kunt u Publiceren selecteren om uw wijzigingen op te slaan. Zodra het publiceren is voltooid, ziet u een bijgewerkte lijst met beschikbare functies in Functions Explorer.

Volgende stappen

• Een item met functies voor fabric-gebruikersgegevens maken in Visual Studio Code
• Meer informatie over het programmeermodel voor functies met gebruikersgegevens