Használja a portálszerkesztőt a felhasználói adatfüggvények megírásához és közzétételéhez.

A Fabric User adatfüggvényeit közvetlenül a böngészőből fejlesztheti a portálszerkesztővel. A portál lehetővé teszi a függvények létrehozását, módosítását, tesztelését és közzétételét a böngészőből. Ebben a cikkben a következő témaköröket ismerheti meg:

• A portálszerkesztő áttekintése.
• Felhasználói adatfüggvények tulajdonságai és metaadatai.
• A portálszerkesztő funkciói.

A portálszerkesztő áttekintése

A portálszerkesztő az a webes felület, amelyhez a User Data Functions-elemek megnyitásakor fér hozzá. A portálszerkesztő elemei a következők:

1. Kezdőlap /Szerkesztés lap: Ezekkel a lapokkal válthat a felső eszköztárra a Kezdőlap eszközei között a Szerkesztési eszközökre.
2. Beállítások: Ez a gomb megnyitja a User Data Functions elem beállításait. A beállítások közé tartozik az elem leírása, a bizalmassági címke, a jóváhagyás, a kapcsolatok kezelése és a tárkezelési beállítások. A menü beállításai az elem összes függvényére érvényesek.
3. Függvények listája: Ez a lista a Felhasználói adatfüggvények elemen belüli függvényeket tartalmazza. Ha Fejlesztés módban van, ez a lista új és nem közzétett függvényeket is tartalmazhat. Ha csak futtatási/megtekintési módban van, ez a lista csak közzétett függvényeket tartalmaz. Ha egy listaelem fölé viszi az egérmutatót, megjelenik a Futtatás vagy tesztelés funkció, valamint a további lehetőségek.
4. Kódmegjelenítő/szerkesztő: A kódszerkesztő tartalmazza a felhasználói adatfüggvények elem összes függvényének kódját. Ha Fejlesztés módban van, ez a kód szerkeszthető, és olyan függvényeket is tartalmazhat, amelyeket még nem tettek közzé. Ha csak futtatási/megtekintési módban van, ez a kód írásvédett, és csak a közzétett függvényeket jeleníti meg.
5. Állapotsor: Ez a sáv két elemet tartalmaz:
   1. Tesztmunkamenet-jelző: A Fejlesztés módban használt jelző jelzi, hogy fut-e a tesztmunkamenet. További információ a függvények teszteléséről a Fejlesztési mód dokumentációjában.
   2. Közzétételi folyamatjelző: Ez a mutató azt jelzi, hogy a függvények közzététele folyamatban van-e, vagy az utolsó sikeres közzétételük időbélyege.
6. Mode switcher: Ez a legördülő menü lehetővé teszi, hogy váltson a Fejlesztés mód és a Csak futtatás/Megtekintés mód között. További információ a Fejlesztés mód dokumentációjában.
7. Megosztás gomb: Ezzel a funkcióval megoszthatja ezt a Felhasználói adatfüggvény-elemet más felhasználókkal, és engedélyeket rendelhet hozzájuk (megosztási, szerkesztési és/vagy végrehajtási engedélyek).
8. Közzététel gomb: Ez a gomb elindítja a User Data Functions elem közzétételi folyamatát. Ez a folyamat az elem összes függvényét közzéteszi. A függvények közzététele után más felhasználók és Fabric-elemek futtathatják a függvényeket.

Kezdőlap eszköztár

Ez az eszköztár olyan funkciókat biztosít, amelyek a Felhasználói adatfüggvények elemek összes függvényére vonatkoznak. Ezen funkciók némelyike csak Fejlesztés módban érhető el.

1. Beállítások: Ez a gomb megnyitja a User Data Functions elem beállításait. A beállítások közé tartozik az elem leírása, a bizalmassági címke, a jóváhagyás, a kapcsolatok kezelése és a tárkezelési beállítások. A menü beállításai az elem összes függvényére érvényesek.
2. Frissítés gomb: Ez a gomb frissíti a User Data Functions elemet a legújabb közzétett függvényekkel és metaadatokkal. Ezzel a funkcióval meggyőződhet arról, hogy a kód legújabb verziójával dolgozik.
3. Nyelvválasztó: Egyelőre ez az írásvédett gomb alapértelmezett beállításként a Pythont jeleníti meg.
4. Híváskód létrehozása: Ez a funkció automatikusan létrehozza a kódot a közzétett függvények alapján. További információ a híváskód generálása funkcióról.
5. Kapcsolatok kezelése: Ez a funkció lehetővé teszi, hogy kapcsolatokat hozzon létre más Fabric-elemekhez a OneLake adatkatalógus használatával. További információ a Kapcsolatok kezelése funkcióról.
6. Könyvtárkezelés: Ezzel a funkcióval nyilvános és privát kódtárakat telepíthet a függvénykód használatához. További információ a Könyvtárkezelés funkcióról.
7. Megnyitás a VS Code-ban gomb: Ez a gomb lehetővé teszi a függvények megnyitását a VS Code-szerkesztőben a Fabric User Data Functions VS Code bővítmény használatával. További információ a VS Code bővítmény használatáról.
8. Közzététel gomb: Ez a gomb elindítja a User Data Functions elem közzétételi folyamatát. Ez a folyamat az elem összes függvényét közzéteszi. Ez a gomb csak Fejlesztés módban engedélyezett.

Eszköztár szerkesztése

Ez az eszköztár funkciókkal segíti a függvénykód szerkesztését. Ezen funkciók némelyike csak Fejlesztés módban érhető el.

1. Kód alaphelyzetbe állítása gomb: Ez a gomb visszaállítja az összes függvényt a kód közzétett verziójára. Ez a funkció visszavon minden olyan kódmódosítást, amely eltér a közzétett függvényektől. Ez a gomb csak Fejlesztés módban engedélyezett.
2. Szerkesztési gombok: Ezek a gombok a következő funkciókat biztosítják a kódszerkesztőhöz: Visszavonás, Ismétlés, Másolás és Beillesztés. Ez a gomb csak Fejlesztés módban engedélyezett.
3. Minta beszúrása: Ez a funkció olyan kódsablonokat biztosít, amelyek segítenek egy adott forgatókönyv első lépéseiben. Miután kiválasztott egy kódsablont, az a függvények alján lesz beszúrva. Győződjön meg arról, hogy telepíti a szükséges kódtárakat, és hozzáadja a szükséges kapcsolatokat a programozási modell irányelveinek megfelelően. Ez a funkció csak Fejlesztés módban engedélyezett.
4. Kapcsolatok kezelése: Ez a funkció lehetővé teszi, hogy kapcsolatokat hozzon létre más Fabric-elemekhez a OneLake adatkatalógus használatával. További információ a Kapcsolatok kezelése funkcióról.
5. Könyvtárkezelés: Ezzel a funkcióval nyilvános és privát kódtárakat telepíthet a függvénykód használatához. További információ a Könyvtárkezelés funkcióról.
6. Keresés és csere: Ezzel a funkcióval kulcsszavakat kereshet a kódszerkesztőben, és szükség szerint lecserélheti őket. Ez a funkció csak Fejlesztés módban engedélyezett.
7. Közzététel gomb: Ez a gomb elindítja a User Data Functions elem közzétételi folyamatát. Ez a folyamat az elem összes függvényét közzéteszi. Ez a gomb csak Fejlesztés módban engedélyezett.

Híváskód létrehozása funkció

Ezzel a funkcióval automatikusan létrehozhat különböző típusú kódsablonokat a függvények alapján. Kétféle kódtípus létezik:

• Ügyfélkód
• OpenAPI-specifikáció

Ügyfélkód

Ez a funkció lehetővé teszi, hogy kódokat hozzon létre a következő forgatókönyvekhez:

• Ügyfélalkalmazás: Ez a funkció létrehoz egy olyan kódot, amely egy alkalmazásban futtatható a Felhasználói adatfüggvények elem nyilvános végpontjával az Ön által választott nyelven.
• Hálójegyzetfüzetek: Ez a funkció létrehoz egy kódot, amely az Ön által választott nyelven futtatható hálójegyzetfüzetekből fut.

Ügyfélalkalmazás

Ez a funkció létrehoz egy kódrészletet, amely meghívja a függvényeket egy ügyfélalkalmazásból. A kódbeállítások között választhat a Python, a C# vagy a Node.js között.

Ez a cikk egy példát tartalmaz arra, hogyan használhatja ezt a meghívási kódot egy Python-ügyfélalkalmazásban.

Hálójegyzetfüzetek

Ez a funkció létrehoz egy kódrészletet, a segítségével meghívhatja a függvényeket egy Hálójegyzetfüzetből.

A különböző nyelvekre vonatkozó további példákért tekintse meg a Fabric Notebooks User Data Functions segédprogramok dokumentációját.

OpenAPI-specifikáció

Az Open API specifikációja, korábbi nevén Swagger Specification, a REST API-k széles körben használt, nyelvspecifikus leírási formátuma. Ez a specifikáció lehetővé teszi, hogy az emberek és a számítógépek egyaránt felfedezzék és megértsék a szolgáltatás képességeit szabványosított formátumban. Ez a specifikáció hasznos a külső rendszerekkel és AI-ügynökökkel való integrációk létrehozásához, valamint az Ügyfélkód bármilyen nyelven történő létrehozásához az OpenAPI Codegen használatával.

Ez a funkció egy OpenAPI-specifikációt hoz létre JSON vagy YAML formátumban az összes függvényhez. Ez a funkció a függvények DOCSTRING tulajdonságát használja a függvényparaméterek, a hibaüzenetek és a végpontok mellett.

Az API-dokumentáció tartalmának meghatározásához használja a következő tulajdonságokat a függvények DOCSTRING-ben:

• Összefoglalás: Ez a mező a függvény egysoros magyarázatát tartalmazza. Az összegzés gyakran megjelenik egy olyan kódtár vagy API magas szintű nézetében, amely a specifikációt használja. Az OpenAPI-sémában ez a tulajdonság az OpenAPI-specifikáció "összegzés" mezőjének felel meg.
• Leírás: Ez a mező a függvény céljának és viselkedésének részletes magyarázatára szolgál. A függvénykimeneteket, bemeneteket, valamint az esetleges mellékhatásokat és kivételeket több sorból is leírhatja. Ez a tulajdonság az OpenAPI-specifikáció "leírás" mezőjének felel meg.

Ez egy példafüggvény EGY DOCSTRING használatával:

@udf.function()
def hello_fabric(name: str) -> str:
    """
    Summary: A Python function that prints your name and the time.
    Description: This functions takes a string input and concatenates it with the current time 
    to give you a warm welcome to User Data Functions. This function returns a string and 
    provides a log entry.
    """
    
    logging.info('Python UDF trigger function processed a request.')

    return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!"

Következő lépések

• További információ a szolgáltatáskorlátozásokról.
• Fabric felhasználói adatfüggvény-elemet hozzon létre a Fabric környezetében, vagy használja a Visual Studio Code bővítményt
• Ismerje meg a felhasználói adatok függvényeinek programozási modelljét