Fabric felhasználói adatfüggvény elem létrehozása a Visual Studio Code-ban

A Fabric User adatfunkciók egy kiszolgáló nélküli rendszer, amellyel gyorsan és egyszerűen fejleszthet alkalmazásokat a Fabric natív adatforrásaiból. Ennek előnye a kiszolgáló nélküli számítástechnika nagyobb rugalmassága és költséghatékonysága a Fabricben. A felhasználói adatfüggvények HTTP-kérésként lesznek meghívva egy szolgáltatás által biztosított végpontra, és a Fabric-natív adatforrásokon működnek.

Ebben a rövid útmutatóban megtudhatja, hogyan hozhat létre felhasználói adatfüggvény-elemet a Visual Studio (VS) Code-ban.

Előfeltételek

• Fabric-munkaterület
• Visual Studio Code
• Python
• Azure Functions Core Tools v4
• Microsoft Fabric-bővítmény
• Felhasználói adatfunkciók kiterjesztése

A munkaterület kiválasztása

1. Nyissa meg a VS Code-ot, és jelentkezzen be a Fabric.

2. A Fabricben nyissa meg a Fabric-munkaterületet vagy hozzon létre egy új munkaterületet.

3. Az Új elem panel megnyitásához válassza az + Új elem lehetőséget.

4. Az Új elem panelen, a Adatok fejlesztéseszakasz alatt, válassza ki a Felhasználói adatfunkciók elemtípust.

5. Adjon nevet az új felhasználóiadat-függvényelemnek, és válassza a Létrehozáslehetőséget. Létrejön az új felhasználói adatfunkció elem.

6. A menüszalagon válassza Python- futtatókörnyezeti nyelvként.

7. Hozzon létre egy virtuális környezetet ehhez a felhasználói adatfüggvényelemhez.

8. Válassza ki a Python futtatókörnyezet verzióját. A felhasználói adatfüggvényekhez a Python 3.11-es verziója szükséges.

9. A mappa virtuális környezetének beállításához válassza az Igenlehetőséget.

10. Több függvény hozzáadásához nyissa meg a function_app.py.

    

Az első függvény írása

Írjon egy felhasználói adatfüggvény-elemet a @udf.function() dekoratőrrel a függvény kezdetének meghatározásához. Megadhat egy bemenetet a függvényhez, például primitív adattípusokat, például str, int, float stb. A függvényen belül megírhatja az egyéni üzleti logikát.

Íme egy példa hello_fabric függvényre.

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

Felhasználói adatkezelési funkciók kezelése a VS Code-ban

A felhasználói adatfunkciókat a Fabric Explorerben a VS Code-ban tekintheti meg az aktuálisan megnyitott munkaterületen.

A Háló munkaterület összes függvénye megnyitható a VS Code Explorerben a szerkesztés megkezdéséhez. Válassza ki a megnyitni kívánt függvényt, majd válassza a Megnyitás az Explorerbenlehetőséget. Megtekintheti a felhasználói adatfüggvények elemében írt kapcsolatokat, kódtárakat és összes függvényt.

Kapcsolatok és tárak kezelése

• Kapcsolatok: A felhasználói adatfüggvényhez hozzáadott összes adatkapcsolat megtekinthető a Fabric Explorerből. Kattintson a jobb gombbal, és válassza a Kapcsolatok kezelése a Fabricben a felhasználói adatfüggvény-elemekhez.

• Könyvtárak: A felhasználói adatfunkciók eleméhez hozzáadott összes könyvtár megtekinthető a Fabric Explorerben. Kattintson a jobb gombbal, és válassza a Könyvtárak kezelése a Fabric-ben lehetőséget új tárak hozzáadásához a felhasználói adatfüggvényekhez.

• Függvények: Itt tekintheti meg az összes közzétett függvényt. Válasszon ki egy függvényt, és hajtsa végre az alábbi műveleteket:

  • Futtassa és tesztelje a függvény VS Code-ban való teszteléséhez api-tesztelési eszközök használata nélkül.
  • A nyilvános URL másolása. Ha ez a funkció nyilvánosan elérhető, akkor külső alkalmazásból indítható.

Helyi mappa a felhasználói adatok kezelésére

A VS Code Explorerben megnyitott felhasználói adatfüggvény tétel a Helyi mappa nézetben látható. A helyi mappa lehetővé teszi a felhasználói adatfüggvényelem helyi módosításainak tesztelését és megtekintését.

• Functions: Megtekintheti a helyi function_app.py fájlban található összes függvényt. Ha egy mintával szeretne kezdeni, kattintson a jobb gombbal a Függvények elemre, és válassza a Függvény hozzáadása lehetőséget a mintafüggvény hozzáadásához.

  

  A függvény helyi teszteléséhez nyomja le F5 a hibakeresés elindításához. Kiválaszthatja a függvényelemet, és kiválaszthatja a Futtatás és hibakereséslehetőséget.

• Kapcsolatok és könyvtárak megtekintése a helyi környezetben: Megjelenítheti a helyi környezetben a local.settings.json összes kapcsolatát és a requirements.txt fájlban lévő könyvtárakat.

  • A local.settings kapcsolatainak szinkronizálása a helyi környezet aktuális kapcsolatlistájának megjelenítéséhez.
  • Szinkronizálja requirements.txt a helyi környezetben található könyvtárak aktuális listájának megjelenítéséhez.

A Felhasználói adatok függvény közzététele

A módosítások tesztelése után tegye közzé a felhasználói adatfunkciót a Fabricen. A módosítások közzététele eltarthat néhány percig.

Helyi hibakeresés töréspontokkal

Válassza F5 lehetőséget a Fabric-függvények hibakereséséhez. A kód bármely pontjára felvehet töréspontot. Hibakeresési módban a rendszer a várt módon éri el a töréspontokat, és teszteli a kódot, ahogy egy üzembe helyezett függvényt tesztelne.

Következő lépések

• Ismerje meg a felhasználói adatok függvényeinek programozási modelljét
• oktatóanyag: Felhasználói adatfüggvények meghívása Python-alkalmazásból