Del via

Opret et element til strukturbrugerdatafunktioner i Visual Studio Code

Fabric User-datafunktioner er en serverløs løsning, der giver dig mulighed for hurtigt og nemt at udvikle programmer oven på Fabric-oprindelige datakilder. Fordelene er øget fleksibilitet og omkostningseffektivitet ved serverløs databehandling i Fabric. Brugerdatafunktioner aktiveres som HTTP-anmodninger til et tjenestebaseret slutpunkt, og de fungerer på dine Fabric-oprindelige datakilder.

I denne vejledning lærer du, hvordan du opretter et element med brugerdatafunktioner i Visual Studio (VS) Code.

Forudsætninger

Vælg dit arbejdsområde

  1. Åbn VS Code, og log på Fabric.

  2. I Fabric åbne dit Fabric-arbejdsområde eller oprette et nyt arbejdsområde.

  3. Vælg + Nyt element for at åbne ruden Nyt element.

  4. I ruden Nyt element under Udvikl dataskal du vælge Brugerdatafunktioner elementtype.

  5. Angiv et navn til det nye element med brugerdatafunktioner, og vælg Opret. Det nye element med brugerdatafunktioner oprettes.

  6. Vælg Python- som kørselssprog på båndet.

  7. Opret et virtuelt miljø for dette element med brugerdatafunktioner.

  8. Vælg Python-kørselsversionen. Brugerdatafunktioner kræver Python Version 3.11.

  9. Angiv det virtuelle miljø for mappen ved at vælge Ja.

  10. Åbn function_app.py for at tilføje mere end én funktion.

    Skærmbillede, der viser et element med brugerdatafunktioner, der er åbnet i VS Code.

Skriv din første funktion

Skriv et element med brugerdatafunktioner med @udf.function() dekoratøren for at definere starten af funktionen. Du kan overføre et input til funktionen, f.eks. primitive datatyper som str, int, float osv. I funktionen kan du skrive din brugerdefinerede forretningslogik.

Her er et eksempel 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()}!"

Administrer brugerdatafunktioner i VS Code

Du kan få vist elementet med brugerdatafunktioner i Fabric Explorer i VS Code i det arbejdsområde, der aktuelt er åbnet.

Skærmbillede, der viser stofstifindervisning og lokal mappevisning.

Alle funktionerne i Fabric-arbejdsområdet kan åbnes i Stifinder i VS Code for at begynde at redigere. Vælg den funktion, du vil åbne, og vælg derefter Åbn i Stifinder. Du kan se forbindelser, biblioteker og alle de funktioner, der er skrevet i elementet brugerdatafunktioner.

Administrer forbindelser og biblioteker

  • Forbindelser: Alle de dataforbindelser, der er tilføjet for din brugerdatafunktion, kan ses fra Fabric Explorer. Højreklik, og vælg Administrer forbindelser i Fabric- for elementerne i brugerdatafunktionerne.

  • biblioteker: Alle de biblioteker, der er tilføjet for elementet med brugerdatafunktioner, kan ses fra Fabric Explorer. Højreklik, og vælg Administrer biblioteker i Fabric for at tilføje nye biblioteker for elementer med brugerdatafunktioner.

  • Functions: Du kan få vist alle publicerede funktioner her. Vælg en funktion, og udfør følgende handlinger:

    • Kør og test for at teste funktionen i VS Code uden at skulle bruge API-testværktøjer.
    • Kopiér offentlig URL-adresse hvis denne funktion er offentligt tilgængelig, skal du kalde fra et eksternt program.

Lokal mappe til administration af dine brugerdatafunktioner

Elementet med brugerdatafunktioner, der er åbnet i VS Code Explorer, er synligt i visningen Lokal mappe. Den lokale mappe giver dig mulighed for at teste og se de lokale ændringer, der er foretaget i brugerdatafunktionselementet.

  • Functions: Du kan få vist alle de funktioner, der findes i din lokale function_app.py-fil. Hvis du vil starte med et eksempel, skal du højreklikke på Functions og vælge Tilføj en funktion for at tilføje en eksempelfunktion.

    Skærmbillede, der viser, hvordan du tilføjer en ny funktion i et element med brugerdatafunktioner til lokal udvikling.

    Hvis du vil teste funktionen lokalt, skal du trykke på F5 for at starte fejlfindingen. Du kan også vælge funktionselementet og vælge Kør og foretag fejlfinding af.

  • Få vist forbindelser og biblioteker for lokale funktioner: Du kan få vist alle de forbindelser, der findes i local.settings.json, og bibliotekerne i requirements.txt fil i dit lokale miljø.

    • Synkroniser forbindelser fra local.settings for at få vist den aktuelle liste over forbindelser i dit lokale miljø.
    • Synkroniser requirements.txt for at få vist den aktuelle liste over biblioteker i dit lokale miljø.

Publicer brugerdatafunktionen

Når du tester dine ændringer, skal du publicere brugerdatafunktionen til Fabric. Det kan tage et par minutter at publicere eventuelle ændringer.

Skærmbillede, der viser, hvordan du publicerer dine ændringer eller nyligt tilføjede funktioner i et element med brugerdatafunktioner til lokal udvikling.

Lokal fejlfinding med pausepunkter

Vælg F5 for at foretage fejlfinding af dine Fabric-funktioner. Du kan tilføje et pausepunkt hvor som helst i din kode. I fejlfindingstilstand rammes dine pausepunkter som forventet og tester din kode, som du ville teste en udrullet funktion.

Skærmbillede, der viser, hvordan du foretager lokal fejlfinding med pausepunkter.

Næste trin

  • Last updated on