Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Выходная привязка Dapr позволяет публиковать сообщение в разделе Dapr во время выполнения функции.
Сведения о настройке и настройке расширения Dapr см. в обзоре расширения Dapr.
Example
Функцию C# можно создать с помощью одного из следующих режимов C#:
Execution model | Description |
---|---|
Изолированная рабочая модель | Код функции выполняется в отдельном рабочем процессе .NET. Используйте поддерживаемые версии .NET и Microsoft .NET Framework. Дополнительные сведения см. в руководстве по запуску функций Azure C# в изолированной рабочей модели. |
In-process model | Код функции выполняется в том же процессе, что и хост-процесс Функций. Поддерживает только версии .NET с долгосрочной поддержкой (LTS). Дополнительные сведения см. в статье Разработка функций библиотеки классов C# с помощью службы "Функции Azure". |
В следующем примере показано использование выходной привязки dapr для выполнения операции публикации Dapr в компоненте и подразделе паба и подраздела.
[FunctionName("PublishOutputBinding")]
public static void Run(
[HttpTrigger(AuthorizationLevel.Function, "post", Route = "topic/{topicName}")] HttpRequest req,
[DaprPublish(PubSubName = "%PubSubName%", Topic = "{topicName}")] out DaprPubSubEvent pubSubEvent,
ILogger log)
{
string requestBody = new StreamReader(req.Body).ReadToEnd();
pubSubEvent = new DaprPubSubEvent(requestBody);
}
В следующем примере создается "TransferEventBetweenTopics"
функция с помощью привязки DaprPublishOutput
с :DaprTopicTrigger
@FunctionName("TransferEventBetweenTopics")
public String run(
@DaprTopicTrigger(
pubSubName = "%PubSubName%",
topic = "A")
String request,
@DaprPublishOutput(
pubSubName = "%PubSubName%",
topic = "B")
OutputBinding<String> payload,
final ExecutionContext context) throws JsonProcessingException {
context.getLogger().info("Java function processed a TransferEventBetweenTopics request from the Dapr Runtime.");
}
В следующем примере выходная привязка Dapr публикации связана с триггером HTTP, зарегистрированным app
объектом:
const { app, trigger } = require('@azure/functions');
app.generic('PublishOutputBinding', {
trigger: trigger.generic({
type: 'httpTrigger',
authLevel: 'anonymous',
methods: ['POST'],
route: "topic/{topicName}",
name: "req"
}),
return: daprPublishOutput,
handler: async (request, context) => {
context.log("Node HTTP trigger function processed a request.");
const payload = await request.text();
context.log(JSON.stringify(payload));
return { payload: payload };
}
});
The following examples show Dapr triggers in a function.json file and PowerShell code that uses those bindings.
Here's the function.json file for daprPublish
:
{
"bindings":
{
"type": "daprPublish",
"direction": "out",
"name": "pubEvent",
"pubsubname": "%PubSubName%",
"topic": "B"
}
}
For more information about function.json file properties, see the Configuration section.
In code:
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
# Example to use Dapr Service Invocation Trigger and Dapr State Output binding to persist a new state into statestore
param (
$subEvent
)
Write-Host "PowerShell function processed a TransferEventBetweenTopics request from the Dapr Runtime."
# Convert the object to a JSON-formatted string with ConvertTo-Json
$jsonString = $subEvent["data"]
$messageFromTopicA = "Transfer from Topic A: $jsonString".Trim()
$publish_output_binding_req_body = @{
"payload" = $messageFromTopicA
}
# Associate values to output bindings by calling 'Push-OutputBinding'.
Push-OutputBinding -Name pubEvent -Value $publish_output_binding_req_body
В следующем примере показана выходная привязка Dapr Publish, которая использует модель программирования Python версии 2. Чтобы использовать код приложения-функции Python, выполните следующие действия daprPublish
.
import logging
import json
import azure.functions as func
app = func.FunctionApp()
@app.function_name(name="TransferEventBetweenTopics")
@app.dapr_topic_trigger(arg_name="subEvent", pub_sub_name="%PubSubName%", topic="A", route="A")
@app.dapr_publish_output(arg_name="pubEvent", pub_sub_name="%PubSubName%", topic="B")
def main(subEvent, pubEvent: func.Out[bytes]) -> None:
logging.info('Python function processed a TransferEventBetweenTopics request from the Dapr Runtime.')
subEvent_json = json.loads(subEvent)
payload = "Transfer from Topic A: " + str(subEvent_json["data"])
pubEvent.set(json.dumps({"payload": payload}).encode('utf-8'))
Attributes
In the in-process model, use the DaprPublish
to define a Dapr publish output binding, which supports these parameters:
function.json property | Description | Можно отправлять с помощью атрибута | Может отправляться через RequestBody |
---|---|---|---|
PubSubName | Имя паба или дочернего файла Dapr для отправки сообщения. | ✔️ | ✔️ |
Topic | Имя раздела Dapr для отправки сообщения. | ✔️ | ✔️ |
Payload | Required. Опубликованное сообщение. | ❌ | ✔️ |
Annotations
Заметка DaprPublishOutput
позволяет получить доступ к опубликованному сообщению функции.
Element | Description | Можно отправлять с помощью атрибута | Может отправляться через RequestBody |
---|---|---|---|
pubSubName | Имя паба или дочернего файла Dapr для отправки сообщения. | ✔️ | ✔️ |
topic | Имя раздела Dapr для отправки сообщения. | ✔️ | ✔️ |
payload | Required. Опубликованное сообщение. | ❌ | ✔️ |
Configuration
В следующей таблице описываются свойства конфигурации привязки, заданные в коде.
Property | Description | Можно отправлять с помощью атрибута | Может отправляться через RequestBody |
---|---|---|---|
pubsubname | Имя службы компонентов издателя. | ✔️ | ✔️ |
topic | Имя или идентификатор раздела издателя. | ✔️ | ✔️ |
payload | Required. Опубликованное сообщение. | ❌ | ✔️ |
The following table explains the binding configuration properties that you set in the function.json file.
function.json property | Description | Можно отправлять с помощью атрибута | Может отправляться через RequestBody |
---|---|---|---|
pubsubname | Имя службы компонентов издателя. | ✔️ | ✔️ |
topic | Имя или идентификатор раздела издателя. | ✔️ | ✔️ |
payload | Required. Опубликованное сообщение. | ❌ | ✔️ |
В следующей таблице описываются свойства конфигурации привязки, заданные @dapp.dapr_publish_output
в коде Python.
Property | Description | Можно отправлять с помощью атрибута | Может отправляться через RequestBody |
---|---|---|---|
pub_sub_name | Имя события издателя. | ✔️ | ✔️ |
topic | Имя или идентификатор раздела издателя. | ✔️ | ✔️ |
payload | Required. Опубликованное сообщение. | ❌ | ✔️ |
Если свойства определены как в атрибутах, так и RequestBody
приоритет присваивается данным, предоставленным в RequestBody
.
See the Example section for complete examples.
Usage
Чтобы использовать выходную привязку Dapr, начните с настройки компонента Dapr pub/sub. Дополнительные сведения о том, какой компонент следует использовать и как настроить его в официальной документации dapr.
- Спецификации компонентов dapr pub/sub
- Практическое руководство. Публикация сообщения и подписка на раздел
Чтобы использовать daprPublish
Python версии 2, настройте проект с правильными зависимостями.
requirements.text
В файле добавьте следующую строку:azure-functions==1.18.0b3
В терминале установите библиотеку Python.
pip install -r .\requirements.txt
Измените
local.setting.json
файл со следующей конфигурацией:"PYTHON_ISOLATE_WORKER_DEPENDENCIES":1