Azure függvény-aktivitás az Azure Data Factory-ban

Vonatkozik: Azure Data Factory Azure Synapse Analytics

Tipp.

Data Factory a Microsoft Fabric a Azure Data Factory következő generációja, egyszerűbb architektúrával, beépített AI-vel és új funkciókkal. Ha még nem ismerkedik az adatintegrációval, kezdje a Fabric Data Factoryvel. A meglévő ADF-számítási feladatok frissíthetők Fabric használatával, hogy elérjék az adatkutatás, a valós idejű elemzés és a jelentéskészítés új képességeit.

A Azure függvénytevékenység lehetővé teszi Azure Functions futtatását egy Azure Data Factory vagy Synapse-folyamatban. Egy Azure függvény futtatásához társított szolgáltatáskapcsolatot kell létrehoznia. Ezután használhatja a társított szolgáltatást egy olyan tevékenységgel, amely meghatározza a végrehajtandó Azure függvényt.

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

Ha egy folyamat Azure függvénytevékenységét szeretné használni, 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. Ha még nincs kijelölve, jelölje ki az új Azure függvénytevékenységet a vásznon, és a Settings lapját a részletek szerkesztéséhez.

    A felhasználói felület képernyőképe egy Azure függvénytevékenységhez.

  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.

    Az új Azure Function társított szolgáltatás létrehozási panel képernyőképe.

  4. Miután kiválasztotta a Azure függvényhez társított szolgáltatást, adja meg a függvény nevét és egyéb adatait a konfiguráció befejezéséhez.

Azure Function-hoz társított szolgáltatás

A Azure függvény visszatérési típusának érvényes JObject kell 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 A Azure függvényalkalmazás URL-címe. Formátum: https://<accountname>.azurewebsites.net. Ez az URL-cím a URL szakaszban található érték, amikor a függvényalkalmazást a Azure portálon tekinti meg Igen
Funkciógomb A Azure függvény 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 A 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ó A 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 Azure Functions alkalmazás konfigurálása Microsoft Entra bejelentkezéshez. 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á az ADF-alkalmazásazonosítót az Adott ügyfélalkalmazások engedélyezett kérelmei szakaszában , valamint az Objektumazonosítót az Adott azonosítókból érkező kérések engedélyezése szakaszban. Az alkalmazásazonosító és az objektumazonosító az alábbi lépések végrehajtásával található:

      1. Nyissa meg a Azure portált
      2. Navigálás vállalati alkalmazásokhoz
      3. Keresse meg a Azure Data Factory/felügyelt identitás nevét.
      4. Másolja ki a táblában található objektum- és alkalmazásazonosítókat.

      Képernyőkép az alkalmazásregisztrációról, amelyen látható, hogy mely mezőket kell kitölteni az alkalmazásazonosítóval és az objektumazonosítóval.

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 A 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 a Azure függvényalkalmazásban, amelyet ez a tevékenység meghív 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

A Azure függvénytevékenység támogatja a routing. 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 a használni kívánt functionName a <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 functionName a függvény kötésének JSON-definíciójában lévő route tulajdonságból kell származzon, 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ó.

A Azure függvénytevékenység támogatja a queries. A lekérdezésnek a functionName részének kell lennie. Ha például a függvény neve HttpTriggerCSharp, és a felvenni kívánt lekérdezés name=hello, akkor a functionName a Azure függvénytevékenységben HttpTriggerCSharp?name=hello néven is létrehozhatja. 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

Azure Functions 230 másodperc után túllépi az időkorlátot a beállításokban konfigurált functionTimeout beállítástól függetlenü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 Functions. 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 Functions cikkben. Beállíthat egy Azure függvénytevékenységet a Durable függvény meghívásához, amely egy másik URI-val rendelkező választ ad vissza, például . 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 itt.

Kapcsolódó tartalom

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

  • Last updated on