Warning
Azure FunctionsのDapr拡張は2027年4月20日に終了し、その日に拡張バンドルから削除される予定です。 この削除は、メイン拡張バンドルバージョン4.42.0以降およびプレビュー拡張バンドルバージョン4.60.0以降に適用されます。
この削除は、Linuxホスティングイメージにプリインストールまたはキャッシュされているバンドルバージョンや、Windowsホスティングを通じて配布されたバージョンにも適用されます。
関数コードから直接 Daprクライアント SDKや Dapr HTTP API に移行し、DAPRトリガーをHTTPトリガー関数に置き換えてDAPRコールバックを受け取ります。 既存のアプリは、メインバンドルを[4.*, 4.42.0)に一時的にピン留めしたり、プレビューバンドルをhost.json[4.*, 4.60.0)にピン留めることができます。 .NETアプリは対応するDapr拡張のNuGetパッケージを直接使用し続けることができます。 古いバンドルをピン留めしたり、NuGetパッケージを使い続けたりしても、2027年4月20日以降のサポート延長や削除日の変更にはつながりません。
Azure Functions は、次の Dapr イベントを使用して、Dapr 入力バインドでトリガーできます。
Dapr 拡張機能のセットアップと構成について詳しくは、Dapr 拡張機能の概要に関する記事をご覧ください。
Example
A C# 関数は、次の C# モードのいずれかを使用して作成できます。
| 実行モデル | Description |
|---|---|
| 分離ワーカー モデル | 関数コードは、別の .NET ワーカー プロセスで実行されます。 .NET と .NET Framework のサポートされているバージョンで使います。 詳細については、 分離ワーカー モデルで C# Azure Functions を実行するためのガイドを参照してください。 |
| インプロセス モデル | 関数コードは、Functions ホスト プロセスと同じプロセスで実行されます。 .NET の長期サポート (LTS) バージョンのみをサポートします。 詳細については、「Azure Functions を使用する C# クラス ライブラリ関数を開発する」を参照してください。 |
[FunctionName("ConsumeMessageFromKafka")]
public static void Run(
// Note: the value of BindingName must match the binding name in components/kafka-bindings.yaml
[DaprBindingTrigger(BindingName = "%KafkaBindingName%")] JObject triggerData,
ILogger log)
{
log.LogInformation("Hello from Kafka!");
log.LogInformation($"Trigger data: {triggerData}");
}
Dapr 入力バインド トリガーの Java コードを次に示します。
@FunctionName("ConsumeMessageFromKafka")
public String run(
@DaprBindingTrigger(
bindingName = "%KafkaBindingName%")
)
app オブジェクトを使用して、daprBindingTriggerを登録します。
const { app, trigger } = require('@azure/functions');
app.generic('ConsumeMessageFromKafka', {
trigger: trigger.generic({
type: 'daprBindingTrigger',
bindingName: "%KafkaBindingName%",
name: "triggerData"
}),
handler: async (request, context) => {
context.log("Node function processed a ConsumeMessageFromKafka request from the Dapr Runtime.");
context.log(context.triggerMetadata.triggerData)
}
});
以下の例は、 function.json ファイル内のDaprトリガーと、それらのバインディングを使用するPowerShellコードを示しています。
の daprBindingTrigger ファイルを次に示します。
{
"bindings": [
{
"type": "daprBindingTrigger",
"bindingName": "%KafkaBindingName%",
"name": "triggerData",
"direction": "in"
}
]
}
function.json ファイルのプロパティについて詳しくは、「構成」セクションをご覧ください。
コードの中で:
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 (
$triggerData
)
Write-Host "PowerShell function processed a ConsumeMessageFromKafka request from the Dapr Runtime."
$jsonString = $triggerData | ConvertTo-Json
Write-Host "Trigger data: $jsonString"
次の例は、 v2 Python プログラミング モデルを使用する Dapr 入力バインド トリガーを示しています。 Python 関数アプリ コードで daprBinding を使用するには:
import logging
import json
import azure.functions as func
app = func.FunctionApp()
@app.function_name(name="ConsumeMessageFromKafka")
@app.dapr_binding_trigger(arg_name="triggerData", binding_name="%KafkaBindingName%")
def main(triggerData: str) -> None:
logging.info('Python function processed a ConsumeMessageFromKafka request from the Dapr Runtime.')
logging.info('Trigger data: ' + triggerData)
Attributes
プロセス中モデルでは、DaprBindingTriggerを使ってDapr入力バインディングをトリガーし、以下のプロパティをサポートします。
| Parameter | Description |
|---|---|
| BindingName | Dapr トリガーの名前。 指定しない場合、関数の名前がトリガー名として使用されます。 |
Annotations
DaprBindingTrigger注釈を使用すると、作成したバインド コンポーネントによってトリガーされる関数を作成できます。
| Element | Description |
|---|---|
| bindingName | Dapr バインドの名前。 |
Configuration
次の表では、コードで設定するバインド構成プロパティについて説明します。
| Property | Description |
|---|---|
| bindingName | バインディングの名前。 |
次の表は、function.json ファイルで設定したバインド構成のプロパティを説明しています。
| function.json のプロパティ | Description |
|---|---|
| bindingName | バインディングの名前。 |
完全な例については、セクションの例を参照してください。
Usage
Dapr 入力バインド トリガーを使用するには、まず Dapr 入力バインド コンポーネントを設定します。 使用するコンポーネントとその設定方法の詳細については、Dapr の公式ドキュメントを参照してください。
Python v2 で daprBindingTrigger を使用するには、正しい依存関係でプロジェクトを設定します。
requirements.textファイルに、次の行を追加します。azure-functions==1.18.0b3ターミナルで、Python ライブラリをインストールします。
pip install -r .\requirements.txt次の構成で
local.setting.jsonファイルを変更します。"PYTHON_ISOLATE_WORKER_DEPENDENCIES":1