Azure-függvénytevékenység az Azure Data Factoryben

  • Cikk

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

Tipp.

Próbálja ki a Data Factoryt a Microsoft Fabricben, amely egy teljes körű elemzési megoldás a nagyvállalatok számára. A Microsoft Fabric az adattovábbítástól az adatelemzésig, a valós idejű elemzésig, az üzleti intelligenciáig és a jelentéskészítésig mindent lefed. Ismerje meg, hogyan indíthat új próbaverziót ingyenesen!

Az Azure Functions-tevékenység lehetővé teszi az Azure Functions Azure Data Factoryben vagy Synapse-folyamatban való futtatását. Azure-függvény futtatásához létre kell hoznia egy társított szolgáltatáskapcsolatot. Ezután használhatja a társított szolgáltatást egy olyan tevékenységgel, amely meghatározza a végrehajtani kívánt Azure-függvényt.

Azure-függvénytevékenység létrehozása felhasználói felülettel

Ha Azure-függvénytevékenységet szeretne használni egy folyamatban, hajtsa végre a következő lépéseket:

  1. Bontsa ki a folyamattevékenységek panel Azure-függvény szakaszát, és húzzon egy Azure-függvénytevékenységet a folyamatvászonra.

  2. Válassza ki az új Azure-függvénytevékenységet a vásznon, ha még nincs kijelölve, és a Gépház lapon szerkessze a részleteket.

    Shows the UI for an Azure Function activity.

  3. Ha még nincs definiálva Azure-függvényhez társított szolgáltatás, az Új lehetőséget választva hozzon létre egy újat. Az új Azure-függvényhez társított szolgáltatáspanelen válassza ki a meglévő Azure-függvényalkalmazás URL-címét, és adjon meg egy függvénykulcsot.

    Shows the new Azure Function linked service creation pane.

  4. Az Azure-függvényhez társított szolgáltatás kiválasztása után adja meg a függvény nevét és egyéb adatait a konfiguráció befejezéséhez.

Azure-függvényhez társított szolgáltatás

Az Azure-függvény visszatérési típusának érvényesnek JObjectkell lennie. (Ne feledje, hogy JArraynem . JObject) A sikertelen kivételével JObject bármely visszatérési típus meghiúsul, és a felhasználói hibát jelzi, hogy a válasz tartalma nem érvényes JObject.

A függvénykulcs biztonságos hozzáférést biztosít a függvénynevekhez, és mindegyik külön egyedi kulcsokkal vagy főkulcsokkal rendelkezik egy függvényalkalmazásban. A felügyelt identitás biztonságos hozzáférést biztosít a teljes függvényalkalmazáshoz. A felhasználónak meg kell adnia a kulcsot a függvény nevének eléréséhez. További információkért tekintse meg a függvénydokumentációt a függvény hozzáférési kulcsával kapcsolatos további információkért

Property Ismertetés Szükséges
Típus A típustulajdonságnak a következőnek kell lennie: AzureFunction Igen
Függvényalkalmazás URL-címe Az Azure-függvényalkalmazás URL-címe. Formátum: https://<accountname>.azurewebsites.net. Ez az URL-cím az URL-szakaszban található érték, amikor megtekinti a függvényalkalmazást az Azure Portalon Igen
Függvénykulcs Az Azure-függvény hozzáférési kulcsa. Kattintson a megfelelő függvény Kezelés szakaszára, és másolja ki a függvénykulcsot vagy a gazdagépkulcsot. További információ: Azure Functions HTTP-eseményindítók és kötések Igen
Authentication Az Azure-függvény meghívásához használt hitelesítési módszer. A támogatott értékek a "Rendszer által hozzárendelt felügyelt identitás" vagy a "névtelen". Igen
Erőforrás-azonosító Az Azure-függvény alkalmazás-(ügyfél-) azonosítója. Váltson a megfelelő függvény Hitelesítés szakaszára, és kérje le az alkalmazás (ügyfél) azonosítóját az Identitásszolgáltató területen. Ez a tulajdonság a rendszer által hozzárendelt felügyelt identitás használatakor jelenik meg. További információ: Az App Service vagy az Azure Functions-alkalmazás konfigurálása a Microsoft Entra-bejelentkezés használatára. Nem

Megjegyzés:

Névtelen hitelesítés használata esetén győződjön meg arról, hogy az Azure-függvény oldalán vette le az identitását.

Azure-függvénytevékenység

Property Ismertetés Engedélyezett értékek Szükséges
Name A folyamat tevékenységének neve Sztring Igen
Típus A tevékenység típusa az "AzureFunctionActivity" Sztring Igen
Társított szolgáltatások Az Azure-függvény társított szolgáltatása a megfelelő Azure-függvényalkalmazáshoz Társított szolgáltatás referenciája Igen
Függvénynév Annak a függvénynek a neve az Azure-függvényalkalmazásban, amelyet ez a tevékenység hív meg Sztring Igen
Metódus REST API metódus a függvényhíváshoz Sztring által támogatott típusok: "GET", "POST", "PUT" Igen
Fejléc A kérelemnek küldött fejlécek. Például a következő kérés nyelvének és típusának beállításához: "fejlécek": { "Accept-Language": "en-us", "Content-Type": "application/json" } Sztring (vagy kifejezés a sztring eredménytípusával) Nem
Törzs A függvény API-metódusnak küldött kéréssel együtt elküldött törzs Sztring (vagy kifejezés a sztring eredménytípusával) vagy objektummal. PUT/POST metódusokhoz szükséges

Tekintse meg a kérelem hasznos adatainak sémáját a Kérelem hasznos adat séma szakaszában.

Útválasztás és lekérdezések

Az Azure-függvénytevékenység támogatja az útválasztást. Ha például az Azure-függvény végpontja https://functionAPP.azurewebsites.net/api/<functionName>/<value>?code=<secret>van, akkor az functionName Azure-függvénytevékenységben a használni kívánt függvény.<functionName>/<value> Ezt a függvényt paraméterezheti úgy, hogy futásidőben biztosítsa a kívánt functionName értéket.

Megjegyzés:

A functionName Durable Functions esetében a függvény kötésének útvonaltulajdonságából kell származnia a JSON-definícióban, hogy tartalmazza az útválasztási információkat. Ha egyszerűen a functionName megadott útvonalrészlet nélkül használja a függvényalkalmazást, az hibát fog eredményezni.

Az Azure-függvénytevékenység a lekérdezéseket is támogatja. A lekérdezést functionNamea . Ha például a függvény neve és HttpTriggerCSharp a belefoglalni kívánt lekérdezés, name=helloakkor az functionName Azure-függvénytevékenységben létrehozhatja a következőt: HttpTriggerCSharp?name=hello. Ez a függvény paraméterezhető, így az érték futásidőben határozható meg.

Időtúllépési és hosszan futó függvények

Az Azure Functions 230 másodperc után időtúllépést hajt végre, függetlenül a functionTimeout beállításokban konfigurált beállítástól. További információkért tekintse meg ezt a cikket. A viselkedés megkerüléséhez kövesse az aszinkron mintát, vagy használja a Durable Functionst. A Durable Functions előnye, hogy saját állapotkövetési mechanizmust kínálnak, így nem kell saját állapotkövetést implementálnia.

További információ a Durable Functionsről ebben a cikkben. Beállíthat egy Azure-függvénytevékenységet a Durable függvény meghívására, amely egy másik URI-val rendelkező választ ad vissza, például ezt a példát. Mivel statusQueryGetUri a függvény futtatása közben a HTTP-állapot 202 értéket adja vissza, webes tevékenység használatával lekérdezheti a függvény állapotát. Webes tevékenység beállítása a url következő @activity('<AzureFunctionActivityName>').output.statusQueryGetUrimezővel: . A Durable függvény befejeződésekor a függvény kimenete a webes tevékenység kimenete lesz.

Minta

Itt talál egy mintát, amely egy Azure-függvényt használ egy tar-fájl tartalmának kinyeréséhez.

Kapcsolódó tartalom

További információ a folyamatokban és tevékenységekben támogatott tevékenységekről.