Aktivita funkce Azure Ve službě Azure Data Factory
PLATÍ PRO: 
Azure Data Factory Azure Synapse Analytics
Tip
Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat až po datové vědy, analýzy v reálném čase, business intelligence a vytváření sestav. Přečtěte si, jak začít používat novou zkušební verzi zdarma.
Aktivita Funkce Azure umožňuje spouštět azure Functions v kanálu Azure Data Factory nebo Synapse. Pokud chcete spustit funkci Azure Functions, musíte vytvořit připojení propojené služby. Propojenou službu pak můžete použít s aktivitou, která určuje funkci Azure, kterou plánujete spustit.
Vytvoření aktivity funkce Azure s uživatelským rozhraním
Pokud chcete v kanálu použít aktivitu funkce Azure Functions, proveďte následující kroky:
Rozbalte část Funkce Azure v podokně Aktivity kanálu a přetáhněte aktivitu funkce Azure Na plátno kanálu.
Pokud ještě není vybraná, vyberte na plátně novou aktivitu funkce Azure Functions a její kartu Nastavení a upravte její podrobnosti.
Pokud ještě nemáte definovanou propojenou službu Azure Functions, vyberte Možnost Nový a vytvořte novou. V novém podokně propojené služby Azure Functions zvolte stávající adresu URL aplikace funkcí Azure a zadejte klíč funkce.
Po výběru propojené služby Azure Functions zadejte název funkce a další podrobnosti pro dokončení konfigurace.
Propojená služba Azure Functions
Návratový typ funkce Azure musí být platný JObject. (Mějte na paměti, že JArray není JObject.) Jakýkoli jiný návratový typ než JObject selže a vyvolá obsah odpovědi uživatele není platným objektem JObject.
Klíč funkce poskytuje zabezpečený přístup k názvu funkce, přičemž každý z nich má samostatné jedinečné klíče nebo hlavní klíč v rámci aplikace funkcí. Spravovaná identita poskytuje zabezpečený přístup k celé aplikaci funkcí. Uživatel musí zadat klíč pro přístup k názvu funkce. Další informace najdete v dokumentaci k funkci, kde najdete další podrobnosti o přístupovém klíči funkce.
| Vlastnost | Popis | Povinní účastníci |
|---|---|---|
| Typ | Vlastnost typu musí být nastavená na: AzureFunction. | Ano |
| Adresa URL aplikace funkcí | Adresa URL aplikace Funkcí Azure Formát je https://<accountname>.azurewebsites.net. Tato adresa URL je hodnota v části Adresa URL při prohlížení aplikace funkcí na webu Azure Portal. |
Ano |
| Funkční klávesa | Přístupový klíč pro funkci Azure Functions Klikněte na oddíl Správa příslušné funkce a zkopírujte klíč funkce nebo klíč hostitele. Další informace najdete tady: Práce s přístupovými klíči | Ano |
| Ověřování | Metoda ověřování používaná pro volání funkce Azure Functions. Podporované hodnoty jsou spravovaná identita přiřazená systémem nebo anonymní. | Ano |
| ID zdroje | ID aplikace (klienta) funkce Azure Functions. Přejděte do části Ověřování příslušné funkce a získejte ID aplikace (klienta) v části Zprostředkovatel identity. Tato vlastnost se zobrazí při použití spravované identity přiřazené systémem. Další informace najdete v tématu Konfigurace služby App Service nebo aplikace Azure Functions tak, aby používala přihlášení Microsoft Entra. | No |
Poznámka:
Pokud používáte anonymní ověřování, ujistěte se, že jste identitu odebrali na straně funkce Azure Functions.
Aktivita funkce Azure
| Vlastnost | Popis | Povolené hodnoty | Povinní účastníci |
|---|---|---|---|
| Název | Název aktivity v kanálu | String | Ano |
| Typ | Typ aktivity je AzureFunctionActivity. | String | Ano |
| Propojená služba | Propojená služba Azure Functions pro odpovídající aplikaci Funkcí Azure | Odkaz na propojenou službu | Ano |
| Název funkce | Název funkce v aplikaci Funkcí Azure, kterou tato aktivita volá | String | Ano |
| metoda | Metoda ROZHRANÍ REST API pro volání funkce | Podporované typy řetězců: GET, POST, PUT | Ano |
| Hlavička | Hlavičky, které se odešlou do požadavku. Pokud chcete například nastavit jazyk a typ požadavku: "headers": { "Accept-Language": "en-us", "Content-Type": "application/json" } | Řetězec (nebo výraz s typem výsledku řetězce) | No |
| Text | Text, který se odešle spolu s požadavkem na metodu rozhraní API funkce | Řetězec (nebo výraz s resultType řetězce) nebo objektu. | Vyžadováno pro metody PUT/POST |
Viz schéma datové části požadavku v části Schéma datové části požadavku.
Směrování a dotazy
Aktivita funkce Azure podporuje směrování. Pokud má vaše funkce Azure Například koncový bod https://functionAPP.azurewebsites.net/api/<functionName>/<value>?code=<secret>, pak functionName se má použít v aktivitě <functionName>/<value>funkce Azure Functions . Tuto funkci můžete parametrizovat tak, aby poskytovala požadovanou functionName za běhu.
Poznámka:
Funkce functionName Durable Functions by měla být převzata z vlastnosti trasy vazby funkce v její definici JSON, aby zahrnovala informace o směrování. functionName Použití podrobností o trase bez zahrnutí způsobí selhání, protože aplikace funkcí nebyla nalezena.
Aktivita funkce Azure také podporuje dotazy. Dotaz musí být součástí .functionName Pokud je HttpTriggerCSharp například název funkce a dotaz, který chcete zahrnout, je name=hello, pak můžete vytvořit functionName v aktivitě funkce Azure jako HttpTriggerCSharp?name=hello. Tuto funkci lze parametrizovat, aby byla hodnota určena za běhu.
Vypršení časového limitu a dlouhotrvajících funkcí
Azure Functions vyprší po 230 sekundách bez functionTimeout ohledu na nastavení, které jste nakonfigurovali v nastavení. Další informace najdete v tomto článku. Chcete-li toto chování obejít, postupujte podle asynchronního vzoru nebo použijte Durable Functions. Výhodou Durable Functions je, že nabízejí vlastní mechanismus sledování stavu, takže nemusíte implementovat vlastní sledování stavu.
Další informace o Durable Functions najdete v tomto článku. Aktivitu funkce Azure Můžete nastavit tak, aby volala Durable Function, která vrátí odpověď s jiným identifikátorem URI, například v tomto příkladu. Vzhledem k tomu, že statusQueryGetUri funkce vrací stav HTTP 202, můžete stav funkce dotazovat pomocí webové aktivity. Nastavte webovou aktivitu s polem nastaveným url na @activity('<AzureFunctionActivityName>').output.statusQueryGetUri. Po dokončení Durable Function bude výstupem funkce výstup webové aktivity.
Vzorek
Tady najdete ukázku, která pomocí funkce Azure Functions extrahuje obsah souboru tar.
Související obsah
Přečtěte si další informace o podporovaných aktivitách v Kanálech a aktivitách.