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:

1. Rozbalte část Funkce Azure v podokně Aktivity kanálu a přetáhněte aktivitu funkce Azure Na plátno kanálu.

2. Vyberte novou aktivitu funkce Azure Na plátně, pokud ještě není vybraná, a její Nastavení kartu a upravte podrobnosti.

   

3. 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.

   

4. 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: Triggery a vazby HTTP služby Azure Functions	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.