Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Van toepassing op:
Azure Data Factory Azure Synapse Analytics
Tip
Data Factory in Microsoft Fabric is de volgende generatie van Azure Data Factory, met een eenvoudigere architectuur, ingebouwde AI en nieuwe functies. Als u nieuw bent in gegevensintegratie, begint u met Fabric Data Factory. Bestaande ADF-workloads kunnen upgraden naar Fabric om toegang te krijgen tot nieuwe mogelijkheden voor gegevenswetenschap, realtime analyses en rapportage.
Met de activiteit Azure Functie kunt u Azure Functions uitvoeren in een Azure Data Factory- of Synapse-pijplijn. Als u een Azure-functie wilt uitvoeren, moet u een gekoppelde serviceverbinding maken. Vervolgens kunt u de gekoppelde service gebruiken met een activiteit die de Azure functie aangeeft die u wilt uitvoeren.
Een Azure-functieactiviteit maken met de gebruikersinterface
Als u een Azure Functie-activiteit in een pijplijn wilt gebruiken, voert u de volgende stappen uit:
Vouw de sectie Azure Functie van het deelvenster Pijplijnactiviteiten uit en sleep een Azure Functie-activiteit naar het pijplijncanvas.
Selecteer de nieuwe Azure Functie-activiteit op het canvas als deze nog niet is geselecteerd en het tabblad Settings om de details ervan te bewerken.
Als u nog geen gekoppelde service voor Azure functie hebt gedefinieerd, selecteert u Nieuw om een nieuwe te maken. Kies in het nieuwe deelvenster gekoppelde service voor Azure Function uw bestaande Azure Function App-url en geef een Function Key op.
Nadat u de gekoppelde Azure functieservice hebt geselecteerd, geeft u de naam van de functie en andere details op om de configuratie te voltooien.
Azure Function gekoppelde service
Het retourtype van de functie Azure moet een geldige JObject zijn. (Houd er rekening mee dat JArraygeenJObject is.) Elk ander retourtype dan JObject leidt tot een fout en genereert de gebruikersfout Response Content is geen geldig JObject.
Functiesleutel biedt veilige toegang tot functienamen, waarbij elke functie binnen een functie-app afzonderlijke unieke sleutels of een hoofdsleutel heeft. Beheerde identiteit biedt beveiligde toegang tot de hele functie-app. De gebruiker moet een sleutel opgeven voor toegang tot de functienaam. Zie de functiedocumentatie voor meer informatie over functietoegangssleutel
| Eigenschappen | Beschrijving | Vereist |
|---|---|---|
| Typ | De eigenschap Type moet worden ingesteld op: AzureFunction | Ja |
| URL van functie-app | URL voor de Azure-functie-app. Indeling is https://<accountname>.azurewebsites.net. Deze URL is de waarde onder URL sectie bij het weergeven van uw functie-app in de Azure-portal |
Ja |
| Functietoets | Toegangssleutel voor de Azure-functie. Selecteer de sectie Beheren voor de betreffende functie en kopieer de functiesleutel of de hostsleutel. Meer informatie hier: Werken met toegangssleutels | Ja |
| Verificatie | De verificatiemethode die wordt gebruikt voor het aanroepen van de Azure-functie. De ondersteunde waarden zijn door het systeem toegewezen beheerde identiteit of 'anoniem'. | Ja |
| Resource-id | De app-id (client) van de Azure-functie. Schakel over naar de sectie Verificatie voor de betreffende functie en haal de app-id (client) op onder Id-provider. Deze eigenschap wordt weergegeven wanneer u door het systeem toegewezen beheerde identiteit gebruikt. Zie Configureer uw App Service of Azure Functions-app om Microsoft Entra-login te gebruiken voor meer informatie. | Nee* |
/* De resourceId eigenschap is vereist wanneer u door het systeem toegewezen beheerde identiteitverificatie gebruikt.
Door het systeem toegewezen beheerde identiteitverificatie
U kunt op twee manieren SAMI-verificatie (door het systeem toegewezen beheerde identiteit) gebruiken:
Stel de resource-id in op
https://management.azure.com. Data Factory maakt verbinding met de functie-app met behulp van de door het systeem toegewezen beheerde identiteit en voert de functie-app uit met anonieme verificatie.Voor beveiligde omgevingen waarvoor u geen anonieme verificatie wilt gebruiken, configureert u een SPN (Service Principal Name) als de resource-id. De SPN moet correct worden geconfigureerd in de functie-app:
Maak een nieuwe app-registratie als een service-principal-identiteit.
Ga in uw functie-app naar de sectie Verificatie onder Instellingen en maak een id-provider.
Voeg de ADF-toepassings-id toe in de sectie Toegestane aanvragen van specifieke clienttoepassingen en de object-id in de sectie Allow requests from specific identifies . U vindt de toepassings-id en object-id door de volgende stappen uit te voeren:
- Open de Azure Portal
- Navigeren naar Bedrijfstoepassingen
- Zoek de naam van uw Azure Data Factory/beheerde identiteit.
- Kopieer de object-ID's en toepassings-ID's die op de tabel staan.
Azure functieactiviteit
| Eigenschappen | Beschrijving | Toegestane waarden | Vereist |
|---|---|---|---|
| Naam | Naam van de activiteit in de pijplijn | String | Ja |
| Typ | Het type activiteit is 'AzureFunctionActivity' | String | Ja |
| Gekoppelde dienst | De gekoppelde Azure-service voor de bijbehorende Azure Functie-app | Gekoppelde dienstreferentie | Ja |
| Functienaam | Naam van de functie in de Azure Functie-app die door deze activiteit wordt aangeroepen | String | Ja |
| Wijze | REST API-methode voor de functie-aanroep | Ondersteunde typen tekenreeksen: 'GET', 'POST', 'PUT' | Ja |
| Koptekst | Kopteksten die naar de aanvraag worden verzonden. Als u bijvoorbeeld de taal en het type wilt instellen voor een aanvraag: "headers": { "Accept-Language": "en-us", "Content-Type": "application/json" } | Tekenreeks (of expressie met resulttype van tekenreeks) | Nee |
| Hoofdtekst | Inhoud die samen met de aanvraag naar de API-methode van de functie wordt verzonden | Tekenreeks (of expressie met resultType van tekenreeks) of object. | Vereist voor PUT-/POST-methoden |
Zie het schema van de aanvraagbelasting in de sectie Aanvraagbelasting.
Routeren en queries
De Azure-functieactiviteit ondersteunt routing. Als uw Azure functie bijvoorbeeld het eindpunt https://functionAPP.azurewebsites.net/api/<functionName>/<value>?code=<secret> heeft, wordt de functionName die u wilt gebruiken in de Azure-functieactiviteit <functionName>/<value>. U kunt deze functie parameteriseren om tijdens runtime de gewenste functionName functie op te geven.
Notitie
De functionName voor Durable Functions moet worden opgehaald uit de eigenschap route van de binding van de functie in de JSON-definitie om de routeringsinformatie op te nemen. Het eenvoudigweg gebruiken van de functionName zonder de opgenomen routedetails resulteert in een mislukking omdat de Function App niet kan worden gevonden.
De Azure-functieactiviteit ondersteunt ook queries. Een query moet worden opgenomen als onderdeel van de functionName. Als de functienaam bijvoorbeeld is HttpTriggerCSharp en de query die u wilt opnemen, is name=hello, kunt u de functionName maken in de Azure functieactiviteit als HttpTriggerCSharp?name=hello. Deze functie kan worden geparameteriseerd, zodat de waarde tijdens runtime kan worden bepaald.
Time-out en langlopende functies
Azure Functions geeft een time-out na 230 seconden, ongeacht de functionTimeout instelling die u hebt geconfigureerd. Zie dit artikel voor meer informatie. Als u dit gedrag wilt omzeilen, volgt u een asynchroon patroon of gebruikt u Durable Functions. Het voordeel van Durable Functions is dat ze hun eigen mechanisme voor statustracering bieden, zodat u uw eigen statustracking niet hoeft te implementeren.
Meer informatie over Durable Functions vindt u in dit artikel. U kunt een Azure-functieactiviteit instellen om de durable function aan te roepen. Hiermee wordt een antwoord met een andere URI geretourneerd, zoals desvoorbeeld. Omdat statusQueryGetUri http-status 202 wordt geretourneerd terwijl de functie wordt uitgevoerd, kunt u de status van de functie peilen met behulp van een webactiviteit. Stel een webactiviteit in met het url veld ingesteld op @activity('<AzureFunctionActivityName>').output.statusQueryGetUri. Wanneer de Durable Function is voltooid, is de uitvoer van de functie de uitvoer van de webactiviteit.
Voorbeeld
U vindt een voorbeeld met een Azure-functie om de inhoud van een tar-bestand te extraheren here.
Gerelateerde inhoud
Meer informatie over ondersteunde activiteiten in Pijplijnen en activiteiten.