Jaa kautta

Fabric-käyttäjätietofunktiokohteen luominen Visual Studio Codessa

Fabric User Data Functions on palvelimeton ratkaisu, jonka avulla voit nopeasti ja helposti kehittää sovelluksia Fabric-alkuperäisten tietolähteiden lisäksi. Hyötyjä ovat Fabricin palvelimettoman tietojenkäsittelyn joustavuuden ja tehokkuuden lisääminen. Käyttäjän tietofunktiot käynnistetään HTTP-pyyntöinä palvelun tarjoamalle päätepisteelle, ja ne toimivat Fabric-alkuperäisissä tietolähteissä.

Tässä pikaoppaassa opit luomaan käyttäjätietofunktiokohteen Visual Studio (VS) Codessa.

Ennakkovaatimukset

Valitse työtilasi

  1. Avaa VS Code ja kirjaudu sisään Fabric.

  2. Avaa Fabric-työtila tai luo uusi työtila .

  3. Avaa Uusi kohde -ruutu valitsemalla + Uusi kohde -.

  4. Valitse Uusi kohde -ruudun kohdasta Kehitä tietojaKäyttäjätietofunktiot, kohdetyyppi.

  5. Anna uudelle käyttäjätietofunktiokohteelle nimi ja valitse Luo. Uusi käyttäjätietofunktiokohde luodaan.

  6. Valitse valintanauhassa, Python suorituksenaikaiseksi kieleksi.

  7. Luo virtuaaliympäristö tälle käyttäjän tietofunktiokohteelle.

  8. Valitse Python-suorituspalveluversio. Käyttäjätietofunktiot edellyttävät Python-versiota 3.11.

  9. Määritä kansion virtuaaliympäristö valitsemalla Kyllä.

  10. Lisää useampi kuin yksi funktio avaamalla function_app.py.

    Näyttökuva, jossa näkyy VS Codessa avattu käyttäjätietofunktiokohde.

Ensimmäisen funktion kirjoittaminen

Määritä funktion alku kirjoittamalla käyttäjätietofunktiokohde @udf.function() decoratorilla. Voit välittää funktiolle syötteen, kuten primitiivitietotyypit, kuten str, int, liukuluku jne. -funktiossa voit kirjoittaa mukautetun liiketoimintalogiikan.

Tässä on esimerkki hello_fabric funktiosta.

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

Käyttäjätietofunktioiden hallinta VS Codessa

Voit tarkastella käyttäjätietofunktiokohdetta Fabric Explorerin VS Codessa avatussa työtilassa.

Näyttökuva, jossa näkyy Fabric Explorer -näkymä ja paikallinen kansionäkymä.

Kaikki Fabric-työtilan toiminnot voidaan avata EXPLORERissa VS Codessa muokkaamisen aloittamiseksi. Valitse haluamasi funktio ja valitse sitten Avaa Explorerissa -. Näet yhteydet, kirjastot ja kaikki käyttäjän tietofunktioon kirjoitetut funktiot.

Yhteyksien ja kirjastojen hallinta

  • Connections: Kaikkia käyttäjätietofunktiollesi lisättyjä tietoyhteyksiä voi tarkastella Fabric Explorerin kautta. Napsauta hiiren kakkospainiketta ja valitse Fabric -yhteyksien hallinta käyttäjätietofunktiokohteille.

  • -kirjastot: Kaikkia käyttäjätietofunktioillesi lisättyjä kirjastoja voi tarkastella Fabric Explorerin kautta. Napsauta hiiren kakkospainiketta ja valitse Fabric kirjastojen hallinta uusien kirjastojen lisäämiseksi käyttäjätietofunktiokohteille.

  • Functions: Voit tarkastella kaikkia julkaistuja funktioita täällä. Valitse funktio ja suorita seuraavat toimet:

    • Suorita ja testaa funktion testaamiseksi VS Codessa käyttämättä ohjelmointirajapinnan testaustyökaluja.
    • Kopioi julkinen URL-, jos tämä funktio on julkisesti käytettävissä ulkoisesta sovelluksesta.

Paikallinen kansio käyttäjätietofunktioiden hallintaan

VS Code Explorerissa avattu käyttäjätietofunktiokohde näkyy Paikallisen kansion näkymässä. Paikallisen kansion avulla voit testata ja tarkastella käyttäjän tietofunktiokohteeseen tehtyjä paikallisia muutoksia.

  • Funktiot: Voit tarkastella kaikkia paikallisessa function_app.py tiedostossasi olevia funktioita. Aloita mallista napsauttamalla hiiren kakkospainikkeella Functions ja valitsemalla Lisää funktio, jos haluat lisätä mallifunktion.

    Näyttökuva, jossa näytetään, miten voit lisätä uuden funktion käyttäjätietofunktiokohteeseen paikallista kehitystä varten.

    Jos haluat testata funktiota paikallisesti, aloita virheenkorjaus painamalla F5. Voit myös valita funktiokohteen ja valita Suorita ja korjaa.

  • Näytä paikallisen funktion yhteydet ja kirjastot: Voit tarkastella kaikkia local.settings.json olevia yhteyksiä ja paikallisen ympäristösi requirements.txt tiedoston kirjastoja.

    • synkronoi yhteydet local.settings- näyttääksesi paikallisen ympäristösi yhteyksien nykyisen luettelon.
    • Synkronoi requirements.txt, jolloin näet nykyisen luettelon paikallisen ympäristösi kirjastoista.

Käyttäjätiedot-funktion julkaiseminen

Kun olet testannut tekemäsi muutokset, julkaise käyttäjän tietofunktio Fabric-funktioon. Muutosten julkaiseminen voi kestää muutaman minuutin.

Näyttökuva, jossa näytetään, miten voit julkaista muutoksia tai juuri lisättyjä funktioita käyttäjätietofunktiokohteessa paikallista kehitystä varten.

Paikallinen virheenkorjaus ja keskeytyspisteet

Korjaa Fabric-funktioiden virheenkorjaus valitsemalla F5. Voit lisätä keskeytyskohdan mihin tahansa kohtaan koodissa. Virheenkorjaus-tilassa keskeytyskohdat saavat odotetun osuman, ja ne testaavat koodiasi samalla tavalla kuin testaisit käyttöön otettua funktiota.

Näyttökuva, jossa näytetään, miten voit korjata virheen paikallisesti keskeytyskohdalla.

Seuraavat vaiheet

  • Last updated on