Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Warning
Rozszerzenie Dapr dla Azure Functions zostanie wycofane 20 kwietnia 2027 roku i planowane jest usunięcie z pakietów rozszerzenia tego dnia. Usunięcie dotyczy pakietu głównego rozszerzenia w wersji 4.42.0 i nowszych oraz pakietu rozszerzenia podglądowego w wersji 4.60.0 i nowszych.
To usunięcie dotyczy również wersji pakietów preinstalowanych lub cacheowanych w obrazach hostingowych Linuksa albo dystrybuowanych przez hosting Windows.
Migruj do Dapr client SDK lub API HTTP Dapr bezpośrednio z kodu funkcji i zastąp wyzwalacze Dapr funkcjami wyzwalanymi przez HTTP, które odbierają odwołania Dapr. Istniejące aplikacje mogą tymczasowo przypiąć główny pakiet lub [4.*, 4.42.0) pakiet podglądowy do [4.*, 4.60.0) .host.json Aplikacje .NET mogą nadal korzystać bezpośrednio z odpowiadających pakietów NuGet do Dapr. Ani przypinanie starszego pakietu, ani dalsze korzystanie z pakietów NuGet nie przedłuża wsparcia po 20 kwietnia 2027 roku ani nie zmienia daty usunięcia.
Usługa Azure Functions może zostać wyzwolona w wywołaniu usługi Dapr przy użyciu następujących zdarzeń języka Dapr.
Aby uzyskać informacje na temat konfiguracji i szczegółów konfiguracji rozszerzenia Języka Dapr, zobacz Omówienie rozszerzenia Języka Dapr.
Example
Funkcję języka C# można utworzyć przy użyciu jednego z następujących trybów języka C#:
| Model wykonania | Description |
|---|---|
| Model izolowanego pracownika | Kod funkcji jest uruchamiany w osobnym procesie roboczym platformy .NET. Używaj z obsługiwanymi wersjami .NET i .NET Framework. Aby dowiedzieć się więcej, zobacz przewodnik dotyczący uruchamiania usługi Azure Functions w języku C# w izolowanym modelu procesu roboczego. |
| Model wewnątrzprocesowy | Kod funkcji jest uruchamiany w tym samym procesie co proces hosta usługi Functions. Obsługuje tylko wersje long term support (LTS) platformy .NET. Aby dowiedzieć się więcej, zobacz Tworzenie funkcji biblioteki klas języka C# przy użyciu usługi Azure Functions. |
[FunctionName("CreateNewOrder")]
public static void Run(
[DaprServiceInvocationTrigger] JObject payload,
[DaprState("%StateStoreName%", Key = "order")] out JToken order,
ILogger log)
{
log.LogInformation("C# function processed a CreateNewOrder request from the Dapr Runtime.");
// payload must be of the format { "data": { "value": "some value" } }
order = payload["data"];
}
Oto kod Java wyzwalacza wywołania usługi Dapr:
@FunctionName("CreateNewOrder")
public String run(
@DaprServiceInvocationTrigger(
methodName = "CreateNewOrder")
)
Użyj obiektu , app aby zarejestrować obiekt daprInvokeOutput:
const { app, trigger } = require('@azure/functions');
app.generic('InvokeOutputBinding', {
trigger: trigger.generic({
type: 'httpTrigger',
authLevel: 'anonymous',
methods: ['POST'],
route: "invoke/{appId}/{methodName}",
name: "req"
}),
return: daprInvokeOutput,
handler: async (request, context) => {
context.log("Node HTTP trigger function processed a request.");
const payload = await request.text();
context.log(JSON.stringify(payload));
return { body: payload };
}
});
Poniższe przykłady pokazują wyzwalacze Dapr w pliku function.json oraz kod PowerShell korzystający z tych powiązań.
Oto plik function.json dla elementu daprServiceInvocationTrigger:
{
"bindings": [
{
"type": "daprServiceInvocationTrigger",
"name": "payload",
"direction": "in"
}
]
}
Aby uzyskać więcej informacji na temat function.json właściwości pliku, zobacz sekcję Konfiguracja.
W kodzie:
using namespace System
using namespace Microsoft.Azure.WebJobs
using namespace Microsoft.Extensions.Logging
using namespace Microsoft.Azure.WebJobs.Extensions.Dapr
using namespace Newtonsoft.Json.Linq
param (
$payload
)
# C# function processed a CreateNewOrder request from the Dapr Runtime.
Write-Host "PowerShell function processed a CreateNewOrder request from the Dapr Runtime."
# Payload must be of the format { "data": { "value": "some value" } }
# Convert the object to a JSON-formatted string with ConvertTo-Json
$jsonString = $payload| ConvertTo-Json
# Associate values to output bindings by calling 'Push-OutputBinding'.
Push-OutputBinding -Name order -Value $payload["data"]
W poniższym przykładzie pokazano wyzwalacz wywołania usługi Dapr, który używa modelu programowania w języku Python w wersji 2. Aby użyć elementu daprServiceInvocationTrigger w kodzie aplikacji funkcji języka Python:
import logging
import json
import azure.functions as func
app = func.FunctionApp()
@app.function_name(name="RetrieveOrder")
@app.dapr_service_invocation_trigger(arg_name="payload", method_name="RetrieveOrder")
@app.dapr_state_input(arg_name="data", state_store="statestore", key="order")
def main(payload, data: str) :
# Function should be invoked with this command: dapr invoke --app-id functionapp --method RetrieveOrder --data '{}'
logging.info('Python function processed a RetrieveOrder request from the Dapr Runtime.')
logging.info(data)
Attributes
W modelu w trakcie procesu używamy , DaprServiceInvocationTrigger aby wywołać wiązanie usługi Dapr, które obsługuje następujące właściwości.
| Parameter | Description |
|---|---|
| MethodName | Optional. Nazwa metody, która powinna być używana przez obiekt wywołujący Dapr. Jeśli nie zostanie określona, nazwa funkcji jest używana jako nazwa metody. |
Annotations
Adnotacja DaprServiceInvocationTrigger umożliwia utworzenie funkcji wywoływanej przez środowisko uruchomieniowe języka Dapr.
| Element | Description |
|---|---|
| methodName | Nazwa metody. |
Configuration
W poniższej tabeli opisano właściwości konfiguracji powiązania ustawione w kodzie.
| Property | Description |
|---|---|
| type | Musi być ustawione na daprServiceInvocationTrigger. |
| name | Nazwa zmiennej reprezentującej dane języka Dapr w kodzie funkcji. |
W poniższej tabeli opisano właściwości konfiguracji powiązania ustawione w pliku function.json.
| właściwość function.json | Description |
|---|---|
| type | Musi być ustawione na daprServiceInvocationTrigger. |
| name | Nazwa zmiennej reprezentującej dane języka Dapr w kodzie funkcji. |
Zobacz sekcję Przykład, aby zapoznać się z kompletnymi przykładami.
Usage
Aby użyć wyzwalacza wywołania usługi Dapr, dowiedz się więcej o składnikach, które mają być używane z wyzwalaczem wywołania usługi i jak je skonfigurować w oficjalnej dokumentacji języka Dapr.
Aby użyć elementu daprServiceInvocationTrigger w języku Python w wersji 2, skonfiguruj projekt przy użyciu poprawnych zależności.
Tworzenie i aktywowanie środowiska wirtualnego.
requirements.textW pliku dodaj następujący wiersz:azure-functions==1.18.0b3W terminalu zainstaluj bibliotekę języka Python.
pip install -r .\requirements.txtlocal.setting.jsonZmodyfikuj plik przy użyciu następującej konfiguracji:"PYTHON_ISOLATE_WORKER_DEPENDENCIES":1