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ługę Azure Functions można wyzwolić w ramach subskrypcji tematu języka 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("TransferEventBetweenTopics")]
public static void Run(
[DaprTopicTrigger("%PubSubName%", Topic = "A")] CloudEvent subEvent,
[DaprPublish(PubSubName = "%PubSubName%", Topic = "B")] out DaprPubSubEvent pubEvent,
ILogger log)
{
log.LogInformation("C# function processed a TransferEventBetweenTopics request from the Dapr Runtime.");
pubEvent = new DaprPubSubEvent("Transfer from Topic A: " + subEvent.Data);
}
Oto kod Języka Java do subskrybowania tematu przy użyciu wyzwalacza tematu języka Dapr:
@FunctionName("PrintTopicMessage")
public String run(
@DaprTopicTrigger(
pubSubName = "%PubSubName%",
topic = "B")
String payload,
final ExecutionContext context) throws JsonProcessingException {
Logger logger = context.getLogger();
logger.info("Java function processed a PrintTopicMessage request from the Dapr Runtime.");
Użyj obiektu , app aby zarejestrować obiekt daprTopicTrigger:
const { app, trigger } = require('@azure/functions');
app.generic('TransferEventBetweenTopics', {
trigger: trigger.generic({
type: 'daprTopicTrigger',
name: "subEvent",
pubsubname: "%PubSubName%",
topic: "A"
}),
return: daprPublishOutput,
handler: async (request, context) => {
context.log("Node function processed a TransferEventBetweenTopics request from the Dapr Runtime.");
context.log(context.triggerMetadata.subEvent.data);
return { payload: context.triggerMetadata.subEvent.data };
}
});
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 daprTopicTrigger:
{
"bindings": [
{
"type": "daprTopicTrigger",
"pubsubname": "%PubSubName%",
"topic": "B",
"name": "subEvent",
"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 (
$subEvent
)
Write-Host "PowerShell function processed a PrintTopicMessage request from the Dapr Runtime."
# Convert the object to a JSON-formatted string with ConvertTo-Json
$jsonString = $subEvent["data"] | ConvertTo-Json -Compress
Write-Host "Topic B received a message: $jsonString"
W poniższym przykładzie przedstawiono wyzwalacz tematu języka Dapr, który używa modelu programowania języka Python w wersji 2. Aby użyć elementu daprTopicTrigger w kodzie aplikacji funkcji języka Python:
import logging
import json
import azure.functions as func
app = func.FunctionApp()
@app.function_name(name="PrintTopicMessage")
@app.dapr_topic_trigger(arg_name="subEvent", pub_sub_name="%PubSubName%", topic="B", route="B")
def main(subEvent) -> None:
logging.info('Python function processed a PrintTopicMessage request from the Dapr Runtime.')
subEvent_json = json.loads(subEvent)
logging.info("Topic B received a message: " + subEvent_json["data"])
Attributes
W modelu w trakcie procesu używamy , DaprTopicTrigger aby wywołać Dapr pub/sub binding, które obsługuje następujące właściwości.
| Parameter | Description |
|---|---|
| PubSubName | Nazwa pubu/sub dapr. |
| Topic | Nazwa tematu języka Dapr. |
Annotations
Adnotacja DaprTopicTrigger umożliwia utworzenie funkcji uruchamianej po odebraniu tematu.
| Element | Description |
|---|---|
| pubSubName | Nazwa pubu/sub dapr. |
| topic | Nazwa tematu języka Dapr. |
Configuration
W poniższej tabeli opisano właściwości konfiguracji powiązania ustawione w kodzie.
| Property | Description |
|---|---|
| pubsubname | Nazwa typu składnika pub/sub dapr. |
| topic | Nazwa tematu. |
W poniższej tabeli opisano właściwości konfiguracji powiązania ustawione w pliku function.json.
| właściwość function.json | Description |
|---|---|
| pubsubname | Nazwa typu składnika pub/sub dapr. |
| topic | Nazwa tematu. |
W poniższej tabeli opisano właściwości konfiguracji powiązania ustawione @dapp.dapr_topic_trigger w kodzie języka Python.
| Property | Description | Można wysłać za pośrednictwem atrybutu | Można wysłać za pośrednictwem elementu RequestBody |
|---|---|---|---|
| pub_sub_name | Nazwa typu składnika subskrypcji Dapr. | ✔️ | ❌ |
| topic | Temat subskrypcji. | ✔️ | ❌ |
Zobacz sekcję Przykład, aby zapoznać się z kompletnymi przykładami.
Usage
Aby użyć wyzwalacza tematu języka Dapr, rozpocznij od skonfigurowania składnika pub/sub języka Dapr. Więcej informacji na temat tego, który składnik ma być używany i jak go skonfigurować, znajdziesz w oficjalnej dokumentacji języka Dapr.
- Specyfikacje składników pub/podrzędnych języka Dapr
- Instrukcje: publikowanie komunikatu i subskrybowanie tematu
Aby użyć elementu daprTopicTrigger 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
Następne kroki
Dowiedz się więcej na temat publikowania i subskrybowania języka Dapr.