Azure Functions triggers en bindingsconcepten

In dit artikel leert u de algemene concepten rondom functietriggers en -bindingen.

Triggers zorgen ervoor dat een functie wordt uitgevoerd. Een trigger definieert hoe een functie wordt aangeroepen en een functie precies één trigger moet hebben. Aan triggers zijn gegevens gekoppeld. Meestal is dit de nettolading waarmee de functie is geactiveerd.

Binding met een functie is een manier om een andere resource declaratief te verbinden met de functie; bindingen kunnen worden verbonden als invoerbindingen, uitvoerbindingen of beide. Gegevens van bindingen worden als parameters doorgegeven aan de functie.

U kunt verschillende bindingen mixen en matchen om aan uw behoeften te voldoen. Bindingen zijn optioneel en een functie kan een of meerdere invoer- en/of uitvoerbindingen hebben.

Met triggers en bindingen kunt u hardcoding van toegang tot andere services vermijden. Uw functie ontvangt gegevens (bijvoorbeeld de inhoud van een wachtrijbericht) in functieparameters. U verzendt gegevens (bijvoorbeeld om een ​​wachtrijbericht te maken) door de retourwaarde van de functie te gebruiken.

Kijk eens naar de volgende voorbeelden van hoe u verschillende functies kunt implementeren.

^* Vertegenwoordigt verschillende wachtrijen

Deze voorbeelden zijn niet volledig bedoeld, maar zijn bedoeld om te illustreren hoe u triggers en bindingen samen kunt gebruiken.

Trigger- en bindingsdefinities

Triggers en bindingen worden verschillend gedefinieerd, afhankelijk van de ontwikkelingstaal.

Voor talen die afhankelijk zijn van function.js, biedt de portal een gebruikersinterface voor het toevoegen van bindingen op het tabblad Integratie. U kunt het bestand ook rechtstreeks in de portal bewerken op het tabblad Code + testen van uw functie. Visual Studio code kunt u eenvoudig een binding toevoegen aan een function.jsbestand door een handige set prompts te volgen.

In .NET en Java definieert het parametertype het gegevenstype voor invoergegevens. Gebruik bijvoorbeeld om te binden aan de tekst van een wachtrijtrigger, een bytematrix om als binair te lezen en een aangepast type om de serialiseren naar een string object te deser serialiseren. Omdat .NET-klassebibliotheekfuncties en Java-functies niet afhankelijk zijn van function.js voor bindingsdefinities, kunnen ze niet worden gemaakt en bewerkt in de portal. C#-portalbewerking is gebaseerd op C#-script, dat gebruikmaakt van function.jsin plaats van kenmerken.

Zie Functies verbinden met Azure-services met behulp van bindingen voor meer informatie over het toevoegen van bindingen aan bestaande functies.

Voor talen die dynamisch worden getypt, zoals JavaScript, gebruikt u de eigenschap dataType in hetfunction.jsin het bestand. Als u bijvoorbeeld de inhoud van een HTTP-aanvraag in binaire indeling wilt lezen, stelt u in dataType op binary :

{
    "dataType": "binary",
    "type": "httpTrigger",
    "name": "req",
    "direction": "in"
}

Andere opties voor dataType zijn stream en string .

Bindingsrichting

Alle triggers en bindingen hebben een direction eigenschap in hetfunction.jsbestand:

• Voor triggers is de richting altijd in
• Invoer- en uitvoerbindingen gebruiken in en out
• Sommige bindingen ondersteunen een speciale inout richting. Als u inout gebruikt, is alleen de geavanceerde editor beschikbaar via het tabblad Integreren in de portal.

Wanneer u kenmerken in een klassebibliotheek gebruikt om triggers en bindingen te configureren, wordt de richting opgegeven in een kenmerkcon constructor of afgeleid van het parametertype.

Bindingen toevoegen aan een functie

U kunt uw functie verbinden met andere services met behulp van invoer- of uitvoerbindingen. Voeg een binding toe door de specifieke definities toe te voegen aan uw functie. Zie Bindingen toevoegen aan eenbestaande functie in Azure Functions .

Ondersteunde bindingen

Dit tabel geeft de bindingen weer die worden ondersteund in de belangrijkste versies van de Azure Functions-runtime:

¹ Vanaf de rumtime 2.x moeten alle bindingen, behalve HTTP en Timer, worden geregistreerd. Raadpleeg Bindingextensies registreren.

² Triggers worden niet ondersteund in het Consumption-abonnement. Vereist runtime-gestuurde triggers.

³ Alleen ondersteund in Kubernetes, IoT Edge en andere zelf-gehoste modi.

Zie Ondersteunde talen voor meer informatie over welke bindingen in preview zijn of goedgekeurd zijn voor productiegebruik.

Voorbeelden van bindingscode

Gebruik de volgende tabel om voorbeelden te vinden van specifieke bindingstypen die laten zien hoe u met bindingen in uw functies kunt werken. Kies eerst het taaltabblad dat overeenkomt met uw project.

Aangepaste bindingen

U kunt aangepaste invoer- en uitvoerbindingen maken. Bindingen moeten worden geschreven in .NET, maar kunnen worden gebruikt vanuit elke ondersteunde taal. Zie Aangepaste invoer- en uitvoerbindingen maken voor meer informatie over het maken van aangepaste bindingen.

Resources

• Bindingexpressie en -patronen
• De retourwaarde van de Azure-functie gebruiken
• Een bindingexpressie registreren
• Testing:
  • Strategieën voor het testen van uw code in Azure Functions
  • Handmatig een niet door HTTP geactiveerde functie uitvoeren
• Bindingsfouten afhandelen

Volgende stappen