Skapa ett objekt för Fabric User data-funktioner i Visual Studio Code

Fabric Användardatafunktioner är en serverlös lösning som gör att du snabbt och enkelt kan utveckla program ovanpå infrastrukturbaserade datakällor. Fördelarna är ökad flexibilitet och kostnadseffektivitet av serverlös databehandling i Fabric. Användardatafunktioner anropas som HTTP-begäranden till en tjänstbaserad slutpunkt och de fungerar på dina fabric-inbyggda datakällor.

I den här snabbstarten får du lära dig hur du skapar ett användardatafunktionsobjekt i Visual Studio -koden (VS).

Förutsättningar

• En Fabric-arbetsyta
• Visual Studio Code
• Python
• Azure Functions Core Tools v4
• Microsoft Fabric-tillägg
• Tillägg för användardatafunktioner

Välj din arbetsyta

1. Öppna VS Code och logga in på Fabric.

2. I Fabric öppna din Fabric-arbetsyta eller skapa en ny arbetsyta.

3. Välj + Nytt objekt för att öppna fönstret Nytt objekt.

4. I panelen "Nytt objekt", under "Utveckla datavärden", välj objekttypen "Användardatafunktioner".

5. Ange ett namn för den nya funktionen för användardata och välj Skapa. Det nya användardatafunktionsobjektet skapas.

6. I flikraden väljer du Python som körningsspråk.

7. Skapa en virtuell miljö för det här användardatafunktionsobjektet.

8. Välj Python-körningsversionen. Användardatafunktioner kräver Python Version 3.11.

9. Ställ in den virtuella miljön för mappen genom att välja Ja.

10. Öppna function_app.py för att lägga till fler än en funktion.

    

Skriv din första funktion

Skriv en användardatafunktion med @udf.function()-dekoreraren för att definiera början av funktionen. Du kan skicka indata för funktionen, till exempel primitiva datatyper som str, int, float osv. I funktionen kan du skriva din anpassade affärslogik.

Här är ett exempel på hello_fabric funktion.

@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()}!" 

Hantera användardatafunktioner i VS Code

Du kan visa användardatafunktionsobjektet i Infrastrukturutforskaren i VS Code på den arbetsyta som är öppen för tillfället.

Alla funktioner på arbetsytan Infrastruktur kan öppnas i Utforskaren i VS Code för att börja redigera. Välj den funktion som du vill öppna och välj sedan Öppna i Utforskaren. Du kan se anslutningar, bibliotek och alla funktioner som skrivits i användardatafunktionsobjektet.

Hantera anslutningar och bibliotek

• Anslutningar: Alla dataanslutningar som har lagts till för din användardatafunktion kan visas från Fabric Explorer. Högerklicka och välj Hantera anslutningar i Fabric för användardatafunktionerna.

• Bibliotek: Alla bibliotek som lagts till för ditt användardatafunktionselement kan ses från Fabric Explorer. Högerklicka och välj Hantera bibliotek i Fabric för att lägga till nya bibliotek för användardatafunktioner.

• Funktioner: Du kan visa alla publicerade funktioner här. Välj en funktion och utför följande åtgärder:

  • Kör och testa för att testa funktionen i VS Code utan att behöva använda API-testverktyg.
  • Kopiera offentlig URL om den här funktionen är offentligt tillgänglig anropa från ett externt program.

Lokal mapp för att hantera dina användardatafunktioner

Det användardatafunktionsobjekt som öppnas i VS Code-utforskaren visas i vyn Lokal mapp. Med den lokala mappen kan du testa och se de lokala ändringar som gjorts i funktionsobjektet för användardata.

• Funktioner: Du kan visa alla funktioner som finns i din lokala fil. För att börja med ett exempel, högerklicka på Functions och välj Lägg till en funktion för att lägga till en exempelfunktion.

  

  Om du vill testa funktionen lokalt trycker du på F5 för att starta felsökning. Du kan också välja funktionsposten och välja Kör och felsök.

• Visa anslutningar och bibliotek för lokal funktion: Du kan visa alla anslutningar som finns i local.settings.json och biblioteken i filen i requirements.txt din lokala miljö.

  • Synkronisera anslutningar från local.settings för att visa den aktuella listan över anslutningar i din lokala miljö.
  • Synkronisera requirements.txt för att visa den aktuella listan över bibliotek i din lokala miljö.

Publicera funktionen Användardata

När du har testat dina ändringar, publicerar du användardatafunktionen till Fabric. Det kan ta några minuter att publicera ändringar.

Lokal felsökning med brytpunkter

Välj F5 för att felsöka dina Fabric-funktioner. Du kan lägga till en brytpunkt var som helst i koden. I felsökningsläge träffas brytpunkterna som förväntat, och du testar koden på samma sätt som du skulle testa en distribuerad funktion.

Nästa steg

• Läs om programmeringsmodellen för användardatafunktioner
• Självstudie: Anropa funktioner för användardata från en Python-applikation