Delen via

Dapr Binding-uitvoerbinding voor Azure Functions

  • Artikel

Met de Dapr-uitvoerbinding kunt u een waarde verzenden naar een Dapr-uitvoerbinding tijdens het uitvoeren van een functie.

Zie het overzicht van de Dapr-extensie voor meer informatie over het instellen en configureren van de Dapr-extensie.

Opmerking

U kunt een C#-functie maken met behulp van een van de volgende C#-modi:

Uitvoeringsmodel Beschrijving
Geïsoleerde werkrolmodel Uw functiecode wordt uitgevoerd in een afzonderlijk .NET-werkproces. Gebruiken met ondersteunde versies van .NET en .NET Framework. Zie .NET geïsoleerde werkprocesfuncties ontwikkelen voor meer informatie.
Model in proces Uw functiecode wordt uitgevoerd in hetzelfde proces als het Functions-hostproces. Ondersteunt alleen LTS-versies (Long Term Support) van .NET. Zie .NET-klassebibliotheekfuncties ontwikkelen voor meer informatie.

In het volgende voorbeeld ziet u hoe u een aanroeptrigger van de Dapr-service en een Dapr-uitvoerbinding gebruikt om een bindingsaanvraag te lezen en te verwerken.

[FunctionName("SendMessageToKafka")]
public static async Task Run(
    [DaprServiceInvocationTrigger] JObject payload,
    [DaprBinding(BindingName = "%KafkaBindingName%", Operation = "create")] IAsyncCollector<object> messages,
    ILogger log)
{
    log.LogInformation("C#  function processed a SendMessageToKafka request.");
    await messages.AddAsync(payload);
}

In het volgende voorbeeld wordt een "SendMessageToKafka" functie gemaakt met behulp van de DaprBindingOutput binding met de DaprServiceInvocationTrigger:

@FunctionName("SendMessageToKafka")
public String run(
        @DaprServiceInvocationTrigger(
            methodName = "SendMessageToKafka") 
        String payload,
        @DaprBindingOutput(
            bindingName = "%KafkaBindingName%", 
            operation = "create")
        OutputBinding<String> product,
        final ExecutionContext context) {
    context.getLogger().info("Java  function processed a SendMessageToKafka request.");
    product.setValue(payload);

    return payload;
}

In het volgende voorbeeld wordt de Dapr-uitvoerbinding gekoppeld aan de Dapr-uitvoertrigger, die is geregistreerd door het app object:

const { app, trigger } = require('@azure/functions');

app.generic('SendMessageToKafka', {
    trigger: trigger.generic({
        type: 'daprServiceInvocationTrigger',
        name: "payload"
    }),
    return: daprBindingOutput,
    handler: async (request, context) => {
        context.log("Node function processed a SendMessageToKafka request from the Dapr Runtime.");
        context.log(context.triggerMetadata.payload)

        return { "data": context.triggerMetadata.payload };
    }
});

In de volgende voorbeelden ziet u Dapr-triggers in een function.json-bestand en PowerShell-code die gebruikmaakt van deze bindingen.

Dit is het function.json-bestand voor daprBinding:

{
  "bindings": 
    {
      "type": "daprBinding",
      "direction": "out",
      "bindingName": "%KafkaBindingName%",
      "operation": "create",
      "name": "messages"
    }
}

Zie de sectie Configuratie voor meer informatie over function.json bestandseigenschappen.

In code:

using namespace System.Net

# Input bindings are passed in via param block.
param($req, $TriggerMetadata)

Write-Host "Powershell SendMessageToKafka processed a request."

$invoke_output_binding_req_body = @{
    "data" = $req
}

# Associate values to output bindings by calling 'Push-OutputBinding'.
Push-OutputBinding -Name messages -Value $invoke_output_binding_req_body

In het volgende voorbeeld ziet u een Dapr Binding-uitvoerbinding die gebruikmaakt van het v2 Python-programmeermodel. Ga als volgt te werk om deze te gebruiken @dapp.dapr_binding_output in de code van uw Python-functie-app:

import logging
import json
import azure.functions as func

app = func.FunctionApp()

@app.function_name(name="SendMessageToKafka")
@app.dapr_service_invocation_trigger(arg_name="payload", method_name="SendMessageToKafka")
@app.dapr_binding_output(arg_name="messages", binding_name="%KafkaBindingName%", operation="create")
def main(payload: str, messages: func.Out[bytes]) -> None:
    logging.info('Python processed a SendMessageToKafka request from the Dapr Runtime.')
    messages.set(json.dumps({"data": payload}).encode('utf-8'))

Kenmerken

Gebruik in het procesmodel de DaprBinding definitie van een Dapr-bindingsuitvoerbinding, die ondersteuning biedt voor deze parameters:

Parameter Description Kan worden verzonden via kenmerk Kan worden verzonden via RequestBody
BindingName De naam van de Dapr-binding. ✔️ ✔️
Bewerking De geconfigureerde bindingsbewerking. ✔️ ✔️
Metagegevens De naamruimte van de metagegevens. ❌ ✔️
Data Vereist. De gegevens voor de bindingsbewerking. ❌ ✔️

Aantekeningen

Met de DaprBindingOutput aantekening kunt u een functie maken waarmee een uitvoerbinding wordt verzonden.

Element Beschrijving Kan worden verzonden via kenmerk Kan worden verzonden via RequestBody
bindingName De naam van de Dapr-binding. ✔️ ✔️
uitvoer De geconfigureerde bindingsbewerking. ✔️ ✔️
metagegevens De naamruimte van de metagegevens. ❌ ✔️
gegevens Vereist. De gegevens voor de bindingsbewerking. ❌ ✔️

Configuratie

In de volgende tabel worden de bindingsconfiguratie-eigenschappen uitgelegd die u in de code hebt ingesteld.

Eigenschappen Beschrijving Kan worden verzonden via kenmerk Kan worden verzonden via RequestBody
bindingName De naam van de binding. ✔️ ✔️
schakelapparatuur optimaliseren De bindingsbewerking. ✔️ ✔️
metagegevens De naamruimte van de metagegevens. ❌ ✔️
gegevens Vereist. De gegevens voor de bindingsbewerking. ❌ ✔️

In de volgende tabel worden de bindingsconfiguratie-eigenschappen uitgelegd die u in het function.json-bestand hebt ingesteld.

function.json-eigenschap Beschrijving Kan worden verzonden via kenmerk Kan worden verzonden via RequestBody
bindingName De naam van de binding. ✔️ ✔️
schakelapparatuur optimaliseren De bindingsbewerking. ✔️ ✔️
metagegevens De naamruimte van de metagegevens. ❌ ✔️
gegevens Vereist. De gegevens voor de bindingsbewerking. ❌ ✔️

In de volgende tabel worden de bindingsconfiguratie-eigenschappen @dapp.dapr_binding_output uitgelegd die u in uw Python-code hebt ingesteld.

Eigenschappen Beschrijving Kan worden verzonden via kenmerk Kan worden verzonden via RequestBody
binding_name De naam van de bindings gebeurtenis. ✔️ ✔️
schakelapparatuur optimaliseren De naam/id van de bindingsbewerking. ✔️ ✔️
metagegevens De naamruimte van de metagegevens. ❌ ✔️
gegevens Vereist. De gegevens voor de bindingsbewerking. ❌ ✔️

Als eigenschappen zijn gedefinieerd in zowel kenmerken als RequestBody, wordt prioriteit gegeven aan gegevens die zijn opgegeven in RequestBody.

Zie de sectie Voorbeeld voor volledige voorbeelden.

Gebruik

Als u de Dapr-uitvoerbinding wilt gebruiken, begint u met het instellen van een Dapr-uitvoerbindingsonderdeel. Meer informatie over welk onderdeel u moet gebruiken en hoe u dit kunt instellen in de officiële Dapr-documentatie.

Als u het daprBinding project in Python v2 wilt gebruiken, stelt u uw project in met de juiste afhankelijkheden.

  1. Een virtuele omgeving maken en activeren.

  2. Voeg in het requirements.text bestand de volgende regel toe:

    azure-functions==1.18.0b3

  3. Installeer de Python-bibliotheek in de terminal.

    pip install -r .\requirements.txt

  4. Wijzig uw local.setting.json bestand met de volgende configuratie:

    "PYTHON_ISOLATE_WORKER_DEPENDENCIES":1

Volgende stappen

Meer informatie over aanroepen van dapr-services.