Fabric használói adatfunkciós elem létrehozása

Ebben az útmutatóban létrehozunk egy új User Data Functions-elemet, és új függvényeket írunk bele. Minden felhasználói adatfüggvény-elem olyan kódot tartalmaz, amely egy vagy több, egyenként futtatható függvényt határoz meg.

Pontosabban az alábbiakat sajátíthatja el:

• Felhasználói adatfunkciók eleme létrehozása.
• Írjon egy új függvényt.
• Függvények kezelése.
• Futtassa a függvényt.

Előfeltételek

• Microsoft Fabric-kapacitás a támogatott régiók egyikében. Ha nem rendelkezik Fabric kapacitással, ingyenes próbakapacitást hozhat létre.
• Az adott kapacitáshoz társított Fabric munkaterület

Új Hálófelhasználói adatfüggvény-elem létrehozása

1. Jelölje ki a munkaterületet, és válassza a + Új elemlehetőséget.
2. Válassza az Elemtípus lehetőséget: Minden elem. Keresse meg és válassza ki felhasználói adatfüggvényeket.

Új felhasználóiadat-függvényelem létrehozása

1. A munkaterületen válassza a + Új elemlehetőséget.

2. A megnyíló panelen keresse meg a user data functions, majd jelölje ki a csempét.

   

3. Adja meg a felhasználói adatfüggvény-elem nevét .

4. Python-függvénysablon létrehozásához válassza hello_fabric lehetőséget. A Functions Explorer megjeleníti az összes közzétett és meghívható függvényt.

   

5. A hello_fabric függvény közzététele után futtathatja a Függvények kezelőjének függvénylistájából.

   

Új függvény hozzáadása a mintából

Ez egy példa arra, hogyan adhat hozzá új függvényt a Insert sample menüből. Ebben az esetben hozzáadunk egy Adatok manipulálása pandas-kódtárral nevű függvényt, amely követelményként használja a pandas könyvtárat. A mintafüggvény hozzáadásához kövesse a következő lépéseket:

1. Győződjön meg arról, hogy Fejlesztés módban van. Válassza Könyvtárkezelési lehetőséget a függvény által igényelt kódtárak hozzáadásához.

   

   Megjegyzés

   fabric_user_data_functions kódtár alapértelmezés szerint hozzáadva, és nem távolítható el. Ez a kódtár a felhasználói adatfüggvények működéséhez szükséges. Frissítenie kell a kódtár verzióját az SDK jövőbeli kiadásaihoz.

2. Válassza pandas könyvtárat, és válassza ki a verziót. A könyvtár hozzáadása után a rendszer automatikusan menti azt a Felhasználói adatfunkciók elembe.

   

3. Válassza a Minta beszúrása lehetőséget, majd válassza az Adatok kezelése a pandas könyvtárral lehetőséget. Ez a művelet mintakódot szúr be a kód alján, a többi függvény után.

   

4. Miután beszúrta a mintát a szerkesztőbe, a Tesztelés funkcióval tesztelheti fejlesztés módban.

5. Ha elkészült, a Módosítások mentéséhez és a függvények frissítéséhez válassza a Közzététel lehetőséget. A közzététel eltarthat néhány percig.

   

6. A közzététel befejezése után az új függvény megjelenik a Functions Explorer listában. Ez a függvény most már készen áll arra, hogy a portálról futtatható legyen, vagy másik alkalmazásból, vagy Fabric elemből, például egy adatfolyamból lehessen meghívni.

   

A függvény futtatása

1. A függvény futtatásához először át kell váltania a Csak futtatás módra a módváltóra kattintva.

   

2. Válassza a Futtatás ikont, amely akkor jelenik meg, ha egy függvényre mutat a Függvények böngésző listájában.

   

3. Adja meg a szükséges paramétereket űrlapként a Functions Explorerben. Ebben az esetben a manipulate_data függvényt fogjuk futtatni, amelyhez egy JSON-sztringre van szükség paraméterként.

   [
    {
     "Name": "John",
     "Age": 22,
     "Gender": "male"
    }
   ]
   

4. A függvény futtatásához válassza a Futtatás lehetőséget.

   

5. Megtekintheti az élő naplókat és a függvény kimenetét annak ellenőrzéséhez, hogy sikeresen futott-e. Ellenkező esetben hibajelzést és naplóbejegyzéseket láthat a függvényhívás során.

Új függvény írása

Minden futtatható függvény egy @udf.function() dekoratorral kezdődik a függvénydefiníció előtt. Tudjon meg többet a Python-programozási modellről. Új függvény írásához a dekoratőr @udf.function()-t az elejére kell helyezni, hogy futtatható függvényként deklarálja. Íme egy példafüggvény:

# This sample allows you to pass a credit card number as an integer and mask it, leaving the last 4 digits. 

@udf.function()
def maskCreditCard(cardNumber: int)-> str:
    # Convert the card number to a string
    cardNumberStr = str(cardNumber)
    
    # Check if the card number is valid
    if not cardNumberStr.isdigit() or not (13 <= len(cardNumberStr) <= 19):
        raise ValueError("Invalid credit card number")
    
    # Mask all but the last four digits
    maskedNumber = '*' * (len(cardNumberStr) - 4) + cardNumberStr[-4:]
    
    return str(maskedNumber)

Ha a függvény elkészült, tegye közzé, hogy futtatható legyen.

A programozási modell alapfogalmai

A Felhasználói adatfüggvények a User Data Functions Python programozási modellt használják az egyes függvények létrehozásához, futtatásához, hibakereséséhez és módosításához. Ez egy belső kódtár, amely biztosítja a szükséges funkciókat a függvények Fabricben való meghívásához és az összes integráció kihasználásához.

Az első függvény létrehozása után a kód első sorai tartalmazzák a sablon futtatásához szükséges kódtárakkal rendelkező importálási utasításokat.

import datetime
import fabric.functions as fn
import logging

udf = fn.UserDataFunctions()

Megjegyzés

A függvények megfelelő futtatásához szükség van a fabric.functions kódtárat tartalmazó importálási utasításra és az utasítást tartalmazó sorra udf = fn.UserDataFunctions(). A függvények nem fognak megfelelően működni, ha ezek a sorok hiányoznak.

• A függvények létrehozásához, futtatásához és kezeléséhez fabric.functions SDK-ra és néhány más fontos kódtárra, például logging egyéni naplók írására van szükség.
• udf=fn.UserDataFunctions() a Felhasználói adatfüggvények elemen belüli függvények definiálására szolgál.

Adatfunkciók kezelése

Függvény átnevezése

1. Fejlesztés módban válassza ki a kódszerkesztőt, és frissítse a függvény nevét. Nevezze át hello_fabric például a következőre hello_fabric1:

   @udf.function()
   def hello_fabric1(name: str) -> str:
      logging.info('Python UDF trigger function processed a request.')
   
      return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!"
   

2. A név módosítása után a módosítások mentéséhez válassza a Közzététel lehetőséget.

3. A módosítások közzététele után a Függvénykezelőben megtekintheti a függvény új nevét.

Függvény törlése

Egy függvény törléséhez válassza ki a függvénykódot a kódszerkesztőben, és távolítsa el a teljes kódszakaszt. Tegye közzé a módosításokat, hogy teljes egészében törölje a felhasználói adatkezelési funkciók eleméből.

Ha például törölni szeretné a hello_fabric függvényt, távolítsa el a következő kódblokkot:

@udf.function()
def hello_fabric(name: str) -> str:
    logging.info('Python UDF trigger function processed a request.')

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

A kód eltávolítása után kiválaszthatja a Közzététel opciót a változtatások elmentéséhez. A közzététel befejezése után megjelenik az elérhető függvények frissített listája a Functions Explorerben.

Következő lépések

• Hozzon létre egy Fabric User data functions elemet a Visual Studio Code-ban
• Ismerje meg a felhasználói adatok funkcióinak programozási modelljét