Tárolt függvények létrehozása és kezelése

A függvények ismételten felhasználható lekérdezések vagy lekérdezésrészek. A valós idejű intelligencia kétféle funkciót támogat:

• Beépített függvények, amelyeket nem lehet módosítani.

• Felhasználó által definiált függvények, amelyek két típusra vannak osztva:

  • Tárolt függvények: felhasználó által definiált függvények, amelyeket adatbázisséma-entitásként tárol és kezel, például táblákként. A tárolt függvények létrehozásáról és kezeléséről további információt a Tárolt függvények kezelésének áttekintése című témakörben talál.
  • Lekérdezéssel definiált függvények: felhasználó által definiált függvények, amelyeket egyetlen lekérdezés hatókörén belül definiál és használ. Ezeket a függvényeket egy let utasítással definiálhatja. További információ a lekérdezésalapú függvények létrehozásáról: Felhasználó által definiált függvény létrehozása.

Ebből a cikkből megtudhatja, hogyan hozhat létre vagy módosíthat egy meglévő tárolt függvényt a .create-or-alterfunction.

További információért a .create-or-alterfunction parancsról, lásd: .create-or-alter function.

Előfeltételek

• munkatér Microsoft Fabric-kompatibilis kapacitással
• Szerkesztési engedélyekkel rendelkező KQL-adatbázis

Függvények létrehozása

Ez a funkció lehetővé teszi meglévő függvények létrehozását vagy módosítását a .create-or-alterfunction parancs használatával. A parancs a függvényt az adatbázis metaadataiban tárolja. Ha a megadott functionName függvény nem létezik az adatbázis metaadatai között, a parancs létrehoz egy új függvényt. Ellenkező esetben a parancs módosítja a névvel ellátott függvényt.

1. Keresse meg a KQL-adatbázist, és válassza az Új>függvényt. A .create-or-alter parancs automatikusan megjelenik az Adatok felfedezése ablakban.

   

2. Írja be a függvény nevét és lekérdezési paramétereit a helyőrző szöveg helyett, majd válassza a Futtatás lehetőséget.

   

   A tárolt függvények az Explorer panel Függvények területén jelennek meg.

   

3. Az Adatok feltárása ablakban futtasson egy lekérdezést, amely ellenőrzi, hogy sikeresen létrehozta vagy módosította-e a függvényt.

   

Tárolt függvények listája

Megtekintheti az adatbázisban tárolt összes függvény listáját. A függvények listájának megnyitásához kattintson a bal gombbal a Függvények lehetőségre, vagy válassza a Függvények megjelenítése lehetőséget a legördülő menüben.

A lista a következőket tartalmazza:

• A függvény mappája és leírása.
• Választható rendezési és keresési képességek adott függvények kereséséhez.

A listában egy függvényre bal gombbal kattintva megnyílik a függvény írásvédett előzetes verziója . A legördülő menüben a Függvény megjelenítése lehetőséget is választhatja a függvény előnézeti verziójának megnyitásához , szerkesztéséhez vagy törléséhez .

Tárolt függvény megtekintése és előnézete

Meglévő tárolt függvény megtekintéséhez vagy előnézetéhez kövesse az alábbi lépéseket:

1. Az Explorer panelen bontsa ki a Függvények szakaszt. A kívánt függvényre kattintva nyissa meg az előnézetet, vagy válassza ki a három elemet, és jelenítse meg a függvényt.

2. Megnyílik a függvényszkript írásvédett verziója az Adatok feltárása ablakban.

   • Az előnézeti eredmények kiválasztásával megtekintheti a függvény eredményeinek előnézetét.
   • Ha a függvény paramétereket tartalmaz, megadhatja ezeknek a paramétereknek az értékeit. Ezután válassza az Előnézeti eredmények lehetőséget a megadott paraméterértékek alapján a kimenet megtekintéséhez.
   • Az előnézeti eredmények legfeljebb 100 rekordot mutatnak a függvény lekérdezése alapján.

   

Tárolt függvény szerkesztése vagy törlése

Meglévő tárolt függvény szerkesztéséhez vagy törléséhez kövesse az alábbi lépéseket:

1. Az Explorer panelen bontsa ki a Függvények szakaszt. Válassza ki a kívánt függvény melletti három elemet.

2. A legördülő menüben válassza az alábbi lehetőségeket:

   • Szerkesztés kóddal a függvényszkript szerkesztéséhez az Adatok feltárása ablakban.
   • Törlés

   

3. Ha módosította a függvényszkriptet, a módosítások mentéséhez válassza a Futtatás lehetőséget .

Kapcsolódó tartalom

• Adatok lekérdezése KQL-lekérdezéskészletben
• Adatszabályzatok módosítása
• Táblafrissítési szabályzat létrehozása