Delen via

Een item met functies voor fabric-gebruikersgegevens maken in Visual Studio Code

Fabric User Data Functions is een serverloze oplossing waarmee u snel en eenvoudig toepassingen kunt ontwikkelen op basis van systeemeigen fabric-gegevensbronnen. De voordelen zijn meer flexibiliteit en kosteneffectiviteit van serverloze computing in Fabric. Functies voor gebruikersgegevens worden aangeroepen als HTTP-aanvragen naar een door de service geleverd eindpunt en ze werken op uw systeemeigen Fabric-gegevensbronnen.

In deze quickstart leert u hoe u een item met gebruikersgegevensfuncties maakt in Visual Studio (VS) Code.

Vereiste voorwaarden

Uw werkruimte selecteren

  1. Open VS Code en meld u aan bij Fabric.

  2. Open uw Fabric-werkruimte in Fabric of maak een nieuwe werkruimte.

  3. Selecteer + Nieuw item om het deelvenster Nieuw item te openen.

  4. Selecteer in het deelvenster Nieuw item onder Gegevens ontwikkelen het itemtype Gebruikersgegevensfuncties .

  5. Geef een naam op voor het nieuwe item met gebruikersgegevensfuncties en selecteer Maken. Het nieuwe item voor functies van gebruikersgegevens is aangemaakt.

  6. Selecteer Python als runtimetaal op de werkbalk.

  7. Maak een virtuele omgeving voor dit item met gebruikersgegevensfuncties.

  8. Selecteer de Python-runtimeversie. Voor functies voor gebruikersgegevens is Python versie 3.11 vereist.

  9. Stel de virtuele omgeving voor de map in door Ja-te selecteren.

  10. Open function_app.py om meer dan één functie toe te voegen.

    Schermopname van een item met gebruikersgegevensfuncties dat is geopend in VS Code.

Schrijf je eerste functie

Schrijf een item met gebruikersgegevensfuncties met de @udf.function() decorator om het begin van de functie te definiëren. U kunt een invoer doorgeven voor de functie, zoals primitieve gegevenstypen zoals str, int, float, enzovoort. Binnen de functie kunt u uw aangepaste bedrijfslogica schrijven.

Hier volgt een voorbeeld van hello_fabric functie.

@udf.function()
def hello_fabric(name: str) -> str:
    # Use logging to write custom logs to help trace and debug issues 
    logging.info('Python UDF trigger function processed a request.')
    logging.info('Executing hello fabric function.')
    
    return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!"

Functies voor gebruikersgegevens beheren in VS Code

U kunt het gebruikersgegevensfuncties-item bekijken in de Fabric Explorer in VS Code binnen de momenteel geopende werkruimte.

Schermopname van de weergave Fabric Explorer en de lokale mapweergave.

Alle functies in de fabric-werkruimte kunnen worden geopend in de Explorer in VS Code om te beginnen met bewerken. Kies de functie die u wilt openen en selecteer vervolgens Openen in Explorer. U kunt verbindingen, bibliotheken en alle functies zien die zijn geschreven in het onderdeel gebruikersgegevensfuncties.

Verbindingen en bibliotheken beheren

  • Verbindingen: alle gegevensverbindingen die zijn toegevoegd voor de functie gebruikersgegevens, kunnen worden weergegeven vanuit Fabric Explorer. Klik met de rechtermuisknop en selecteer Verbindingen beheren in Fabric voor de items van de gebruikersgegevensfuncties.

  • Bibliotheken: alle bibliotheken die zijn toegevoegd voor het item gebruikersgegevensfuncties, kunnen worden weergegeven vanuit Fabric Explorer. Klik met de rechtermuisknop en selecteer Bibliotheken beheren in Fabric om nieuwe bibliotheken toe te voegen voor de items van de gebruikersgegevensfuncties.

  • Functions: u kunt hier alle gepubliceerde functies bekijken. Selecteer een functie en voer deze acties uit:

    • uitvoeren en testen om de functie in VS Code te testen zonder api-testhulpprogramma's te hoeven gebruiken.
    • Openbare URL kopiëren als deze functie openbaar toegankelijk is, om deze vanuit een externe toepassing aan te roepen.

Lokale map voor het beheren van de functies voor gebruikersgegevens

Het item gebruikersgegevensfuncties dat is geopend in VS Code Explorer, is zichtbaar in de weergave Lokale map. Met de lokale map kunt u de lokale wijzigingen in het functie-item voor gebruikersgegevens testen en bekijken.

  • Functions: u kunt alle functies weergeven die zich in uw lokale function_app.py-bestand bevinden. Als u met een voorbeeld wilt beginnen, klikt u met de rechtermuisknop op Functions en selecteert u Een functie toevoegen om een voorbeeldfunctie toe te voegen.

    Schermopname waarin wordt getoond hoe u een nieuwe functie toevoegt aan een item met gebruikersgegevensfuncties voor lokale ontwikkeling.

    Als u de functie lokaal wilt testen, drukt u op F5- om foutopsporing te starten. U kunt ook het functie-item selecteren en Uitvoeren en fouten opsporen.

  • Verbindingen en bibliotheken voor lokale functies weergeven: u kunt alle verbindingen weergeven die aanwezig zijn in local.settings.json en de bibliotheken in requirements.txt bestand in uw lokale omgeving.

    • verbindingen synchroniseren vanaf local.settings om de huidige lijst met verbindingen in uw lokale omgeving weer te geven.
    • Synchroniseren requirements.txt om de huidige lijst met bibliotheken in uw lokale omgeving weer te geven.

De functie Gebruikersgegevens publiceren

Nadat u uw wijzigingen hebt getest, publiceert u de functie gebruikersgegevens naar Fabric. Het kan enkele minuten duren voordat wijzigingen zijn gepubliceerd.

Schermopname van het publiceren van uw wijzigingen of zojuist toegevoegde functies in een item met gebruikersgegevensfuncties voor lokale ontwikkeling.

Lokale foutopsporing met onderbrekingspunten

Selecteer F5- om fouten in uw Fabric-functies op te sporen. U kunt overal in uw code een onderbrekingspunt toevoegen. In de debugmodus worden uw onderbrekingspunten zoals verwacht bereikt en test u uw code zoals u een geïmplementeerde functie zou testen.

Schermafbeelding waarin wordt getoond hoe u lokaal kunt debuggen met behulp van breakpoints.

Volgende stappen

  • Last updated on