Del via

Opprette et element for strukturbrukerdatafunksjoner i Visual Studio Code

Fabric User-datafunksjoner er en serverløs løsning som gjør det mulig å raskt og enkelt utvikle programmer på toppen av fabric-native datakilder. Fordelene er økt fleksibilitet og kostnadseffektivitet av serverløs databehandling i Fabric. Brukerdatafunksjoner aktiveres som HTTP-forespørsler til et tjenestegitt endepunkt, og de opererer på de fabric-opprinnelige datakildene.

I denne hurtigstarten lærer du hvordan du oppretter et element for brukerdatafunksjoner i Visual Studio (VS)-kode.

Forutsetninger

Velg arbeidsområdet

  1. Åpne VS Code og logg på Fabric.

  2. I Fabric åpne Fabric-arbeidsområdet eller opprette et nytt arbeidsområde.

  3. Velg + Nytt element for å åpne Ny element-ruten.

  4. Velg Brukerdatafunksjoner elementtype under Utvikle datai ruten Nytt element under Utvikle data.

  5. Angi et navn for elementet for nye brukerdatafunksjoner, og velg Opprett. Elementet for nye brukerdatafunksjoner opprettes.

  6. Velg Python- som kjøretidsspråk på båndet.

  7. Opprett et virtuelt miljø for dette elementet for brukerdatafunksjoner.

  8. Velg Python-kjøretidsversjonen. Brukerdatafunksjoner krever Python versjon 3.11.

  9. Angi det virtuelle miljøet for mappen ved å velge Ja.

  10. Åpne function_app.py for å legge til mer enn én funksjon.

    Skjermbilde som viser et element for brukerdatafunksjoner som er åpnet i VS Code.

Skriv din første funksjon

Skriv et element for brukerdatafunksjoner med @udf.function()-dekoratøren for å definere starten på funksjonen. Du kan sende en inndata for funksjonen, for eksempel primitive datatyper som str, int, float osv. I funksjonen kan du skrive den egendefinerte forretningslogikken.

Her er et eksempel på hello_fabric funksjon.

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

Behandle brukerdatafunksjoner i VS Code

Du kan vise elementet brukerdatafunksjoner i Stoffutforsker i VS Code i det åpne arbeidsområdet.

Skjermbilde som viser stoffutforskervisning og lokal mappevisning.

Alle funksjonene i Fabric-arbeidsområdet kan åpnes i Explorer i VS Code for å begynne å redigere. Velg funksjonen du vil åpne, og velg deretter Åpne i Explorer. Du kan se tilkoblinger, biblioteker og alle funksjonene som er skrevet i elementet for brukerdatafunksjoner.

Behandle tilkoblinger og biblioteker

  • Tilkoblinger: Alle datatilkoblingene som er lagt til for brukerdatafunksjonen, kan vises fra Stoffutforsker. Høyreklikk og velg Behandle tilkoblinger i Fabric for elementene for brukerdatafunksjoner.

  • biblioteker: Alle bibliotekene som er lagt til for elementet for brukerdatafunksjoner, kan vises fra Stoffutforsker. Høyreklikk og velg Behandle biblioteker i Fabric for å legge til nye biblioteker for elementene for brukerdatafunksjoner.

  • Funksjoner: Du kan vise alle de publiserte funksjonene her. Velg en funksjon, og utfør disse handlingene:

    • Kjør og test for å teste funksjonen i VS Code uten å måtte bruke API-testverktøy.
    • Kopier offentlig URL-adresse hvis denne funksjonen er offentlig tilgjengelig aktivering fra eksternt program.

Lokal mappe for å administrere brukerdatafunksjonene

Elementet for brukerdatafunksjoner som er åpnet i VS Code Explorer, er synlig i lokal mappevisning. Med den lokale mappen kan du teste og se de lokale endringene som er gjort i brukerdatafunksjonselementet.

  • Funksjoner: Du kan vise alle funksjonene som er i den lokale function_app.py filen. Hvis du vil starte med et eksempel, høyreklikker du på Funksjoner og velger Legg til en funksjon for å legge til en eksempelfunksjon.

    Skjermbilde som viser hvordan du legger til en ny funksjon i et element for brukerdatafunksjoner for lokal utvikling.

    Hvis du vil teste funksjonen lokalt, trykker du på F5 for å starte feilsøkingen. Du kan også velge funksjonselementet og velge Kjør og feilsøke.

  • Vise tilkoblinger og biblioteker for lokal funksjon: Du kan vise alle tilkoblingene som finnes i local.settings.json og bibliotekene i requirements.txt filen i det lokale miljøet.

    • Synkronisere tilkoblinger fra local.settings for å vise gjeldende liste over tilkoblinger i det lokale miljøet.
    • Synkroniser requirements.txt for å vise gjeldende liste over biblioteker i det lokale miljøet.

Publiser brukerdatafunksjonen

Når du har testet endringene, publiserer du brukerdatafunksjonen til Fabric. Det kan ta noen minutter å publisere eventuelle endringer.

Skjermbilde som viser hvordan du publiserer endringene eller nylig lagt til funksjoner i et element for brukerdatafunksjoner for lokal utvikling.

Lokal feilsøking med breakpoints

Velg F5 for å feilsøke stofffunksjonene dine. Du kan legge til et breakpoint hvor som helst i koden. I feilsøkingsmodus blir breakpoints truffet som forventet og tester koden på samme måte som du ville testet en distribuert funksjon.

Skjermbilde som viser hvordan du feilsøker lokalt med breakpoints.

Neste trinn

  • Last updated on