Azure Functions の Dapr 入力バインド トリガー

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 バインディングの名前。

次の表は、Python コードで設定する @dapp.dapr_binding_trigger のバインド構成プロパティについて説明しています。

Property Description
binding_name バインディングの名前。

完全な例については、セクションの例を参照してください。

Usage

Dapr 入力バインド トリガーを使用するには、まず Dapr 入力バインド コンポーネントを設定します。 使用するコンポーネントとその設定方法の詳細については、Dapr の公式ドキュメントを参照してください。

Python v2 で daprBindingTrigger を使用するには、正しい依存関係でプロジェクトを設定します。

  1. 仮想環境を作成してアクティブにする。

  2. requirements.text ファイルに、次の行を追加します。

    azure-functions==1.18.0b3
    
  3. ターミナルで、Python ライブラリをインストールします。

    pip install -r .\requirements.txt
    
  4. 次の構成で local.setting.json ファイルを変更します。

    "PYTHON_ISOLATE_WORKER_DEPENDENCIES":1
    

次のステップ

Dapr サービス呼び出しの詳細。