Azure Functions の Dapr Binding 出力バインド

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日以降のサポート延長や削除日の変更にはつながりません。

Dapr 出力バインドを使用すると、関数の実行中に値を Dapr 出力バインドに送信できます。

Dapr 拡張機能のセットアップと構成について詳しくは、Dapr 拡張機能の概要に関する記事をご覧ください。

Example

A C# 関数は、次の C# モードのいずれかを使用して作成できます。

実行モデル Description
分離ワーカー モデル 関数コードは、別の .NET ワーカー プロセスで実行されます。 .NET と .NET Framework のサポートされているバージョンで使います。 詳細については、 分離ワーカー モデルで C# Azure Functions を実行するためのガイドを参照してください。
インプロセス モデル 関数コードは、Functions ホスト プロセスと同じプロセスで実行されます。 .NET の長期サポート (LTS) バージョンのみをサポートします。 詳細については、「Azure Functions を使用する C# クラス ライブラリ関数を開発する」を参照してください。

次の例では、Dapr サービス呼び出しトリガーと Dapr 出力バインドを使用して、バインド要求を読み取って処理する方法を示します。

[FunctionName("SendMessageToKafka")]
public static async Task Run(
    [DaprServiceInvocationTrigger] JObject payload,
    [DaprBinding(BindingName = "%KafkaBindingName%", Operation = "create")] IAsyncCollector<object> messages,
    ILogger log)
{
    log.LogInformation("C#  function processed a SendMessageToKafka request.");
    await messages.AddAsync(payload);
}

次の例では、"SendMessageToKafka" バインドと DaprBindingOutput を使って、DaprServiceInvocationTrigger 関数を作成します。

@FunctionName("SendMessageToKafka")
public String run(
        @DaprServiceInvocationTrigger(
            methodName = "SendMessageToKafka") 
        String payload,
        @DaprBindingOutput(
            bindingName = "%KafkaBindingName%", 
            operation = "create")
        OutputBinding<String> product,
        final ExecutionContext context) {
    context.getLogger().info("Java  function processed a SendMessageToKafka request.");
    product.setValue(payload);

    return payload;
}

次の例では、Dapr 出力バインドは、app オブジェクトによって登録される Dapr 呼び出し出力トリガーとペアになっています。

const { app, trigger } = require('@azure/functions');

app.generic('SendMessageToKafka', {
    trigger: trigger.generic({
        type: 'daprServiceInvocationTrigger',
        name: "payload"
    }),
    return: daprBindingOutput,
    handler: async (request, context) => {
        context.log("Node function processed a SendMessageToKafka request from the Dapr Runtime.");
        context.log(context.triggerMetadata.payload)

        return { "data": context.triggerMetadata.payload };
    }
});

以下の例は、 Dapr トリガーをfunction.jsonファイル内のものと、それらのバインディングを使用するPowerShell コードを示しています。

の daprBinding ファイルを次に示します。

{
  "bindings": 
    {
      "type": "daprBinding",
      "direction": "out",
      "bindingName": "%KafkaBindingName%",
      "operation": "create",
      "name": "messages"
    }
}

function.json ファイルのプロパティについて詳しくは、「構成」セクションをご覧ください。

コードの中で:

using namespace System.Net

# Input bindings are passed in via param block.
param($req, $TriggerMetadata)

Write-Host "Powershell SendMessageToKafka processed a request."

$invoke_output_binding_req_body = @{
    "data" = $req
}

# Associate values to output bindings by calling 'Push-OutputBinding'.
Push-OutputBinding -Name messages -Value $invoke_output_binding_req_body

次の例は、v2 Python プログラミング モデルを使用する Dapr Binding 出力バインドを示したものです。 Python 関数アプリ コードで @dapp.dapr_binding_output を使用するには:

import logging
import json
import azure.functions as func

app = func.FunctionApp()

@app.function_name(name="SendMessageToKafka")
@app.dapr_service_invocation_trigger(arg_name="payload", method_name="SendMessageToKafka")
@app.dapr_binding_output(arg_name="messages", binding_name="%KafkaBindingName%", operation="create")
def main(payload: str, messages: func.Out[bytes]) -> None:
    logging.info('Python processed a SendMessageToKafka request from the Dapr Runtime.')
    messages.set(json.dumps({"data": payload}).encode('utf-8'))

Attributes

インプロセスモデルでは、DaprBindingを使ってDaprバインディング出力バインディングを定義し、以下のパラメータをサポートします:

Parameter Description Attribute を使って送信できる RequestBody を使って送信できる
BindingName Dapr バインドの名前。 ✔️ ✔️
Operation 構成されたバインド操作。 ✔️ ✔️
Metadata メタデータ名前空間。 ❌ ✔️
Data Required. バインド操作のデータ。 ❌ ✔️

Annotations

注釈 DaprBindingOutput を使用すると、出力バインドを送信する関数を作成できます。

Element Description Attribute を使って送信できる RequestBody を使って送信できる
bindingName Dapr バインドの名前。 ✔️ ✔️
output 構成されたバインド操作。 ✔️ ✔️
metadata メタデータ名前空間。 ❌ ✔️
data Required. バインド操作のデータ。 ❌ ✔️

Configuration

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

Property Description Attribute を使って送信できる RequestBody を使って送信できる
bindingName バインディングの名前。 ✔️ ✔️
operation バインド操作。 ✔️ ✔️
metadata メタデータ名前空間。 ❌ ✔️
data Required. バインド操作のデータ。 ❌ ✔️

次の表は、function.json ファイルで設定したバインド構成のプロパティを説明しています。

function.json のプロパティ Description Attribute を使って送信できる RequestBody を使って送信できる
bindingName バインディングの名前。 ✔️ ✔️
operation バインド操作。 ✔️ ✔️
metadata メタデータ名前空間。 ❌ ✔️
data Required. バインド操作のデータ。 ❌ ✔️

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

Property Description Attribute を使って送信できる RequestBody を使って送信できる
binding_name バインド イベントの名前。 ✔️ ✔️
operation バインド操作の名前または識別子。 ✔️ ✔️
metadata メタデータ名前空間。 ❌ ✔️
data Required. バインド操作のデータ。 ❌ ✔️

プロパティが Attributes と RequestBody の両方で定義されている場合は、RequestBody で指定されているデータが優先されます。

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

Usage

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

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

  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 サービス呼び出しの詳細。