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

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 kapcsolt szolgáltatást egy olyan tevékenységgel, amely meghatározza a végrehajtani kívánt Azure-függvényt.

Azure Function aktivitás létrehozása a felhasználói felületen keresztül

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 Beállítások lapot a részletek szerkesztéséhez.

   

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.

   

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 egy objektumJObject.) Bármilyen más visszatérési típus, mint a JObject, meghiúsul, és a felhasználói hibát jelzi: 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

Tulajdonság	Leírá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 szakasz alatti érték, amikor megtekinti a függvényalkalmazását az Azure Portalon.	Igen
Funkciógomb	Az Azure Function hozzáférési kulcsa. Válassza ki a megfelelő függvény Kezelés szakaszát, és másolja a függvénykulcsot vagy a gazdagépkulcsot. További információ: A hívóbetűk használata	Igen
Hitelesítés	Az Azure-függvény meghívásához használt hitelesítési módszer. A támogatott értékek a rendszerhozzárendelt felügyelt identitás vagy "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*

/* A resourceId tulajdonságra a rendszer által hozzárendelt felügyelt identitás hitelesítése esetén van szükség.

Rendszer által hozzárendelt felügyelt identitás hitelesítése

A rendszer által hozzárendelt felügyelt identitás (SAMI) hitelesítését kétféleképpen használhatja:

• Állítsa be az erőforrás-azonosítót a következőre https://management.azure.com: . A Data Factory a rendszer által hozzárendelt felügyelt identitással csatlakozik a függvényalkalmazáshoz, és névtelen hitelesítéssel hajtja végre a függvényalkalmazást.

• Olyan biztonságos környezetek esetén, ahol nem szeretne névtelen hitelesítést használni, konfiguráljon egy egyszerű szolgáltatásnevet (SPN) erőforrás-azonosítóként. A szolgáltatásnév (SPN) helyes konfigurálása szükséges a függvényalkalmazáson:

  1. Új alkalmazásregisztráció létrehozása szolgáltatásnév-identitásként.

  2. A függvényalkalmazásban lépjen a Beállítások területen a Hitelesítés szakaszra, és hozzon létre egy identitásszolgáltatót.

  3. Adja hozzá a szolgáltatásnév alkalmazásazonosítóját az Engedélyezett ügyfélalkalmazásban, valamint a szolgáltatásnév objektumazonosítóját az Engedélyezett objektumalkalmazásokban. Ha a kérések csak adott bérlőktől engedélyezettek, adja hozzá a felügyelt identitás bérlőazonosítóját az utolsó mezőben.

     

Azure-függvénytevékenység

Tulajdonság	Leírás	Engedélyezett értékek	Szükséges
Név	A csővezeték 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ényhez kapcsolódó szolgáltatás 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éréshez 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" }	Karakterlánc (vagy string eredménytípusú kifejezés)	Nem
Törzs	A függvény API-metódusnak küldött kéréssel együtt küldött törzs	Sztring (vagy egy szstring típusú eredményt adó kifejezés) vagy objektum.	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 Function aktivitás 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>, akkor az Azure-függvénytevékenységben functionName a használni kívánt végpont <functionName>/<value>. Ezt a függvényt paraméterezheti úgy, hogy futásidőben biztosítsa a kívánt functionName értéket.

Feljegyzés

A Durable Functions esetében a functionName a JSON-definícióban lévő függvény kötésének útvonaltulajdonságából kell származnia, hogy tartalmazza az útválasztási információkat. Ha egyszerűen az functionName útvonal részletei nélkül használja, az hibát eredményez, mert a függvényalkalmazás nem található.

Az Azure-függvénytevékenység a lekérdezéseket is támogatja. A lekérdezésnek a functionName részének kell lennie. Például, ha a függvény neve HttpTriggerCSharp és a belefoglalni kívánt lekérdezés name=hello, akkor az Azure-függvénytevékenységben a functionName-t úgy hozhatja létre, hogy 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 hosszú ideig futó függvények

Az Azure Functions 230 másodperc után futási időkorlátot ér el, függetlenül a functionTimeout beállításokban konfigurált beállításoktó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 mező @activity('<AzureFunctionActivityName>').output.statusQueryGetUri értékkel. Amikor a Durable függvény befejeződik, a függvény kimenete a webes tevékenység kimenete.

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

Tudjon meg többet a Folyamatok és tevékenységek támogatott tevékenységeiről.