Durable Functionsバージョンと移行ガイド

Durable Functions は、Azure Functions および Azure WebJobs の拡張機能であり、サーバーレス環境でステートフル関数を記述できます。 この拡張機能は状態、チェックポイント、再起動を管理します。 Durable Functionsにまだ慣れていない場合は、overview のドキュメントを参照してください。

バージョンの概要

v3.x の新機能

Microsoft.Azure。WebJobs.Extensions.DurableTask v3 パッケージ (以降のセクションでは WebJobs.Extensions.DurableTask と呼ばれます) は、現在推奨されているバージョンです。 v2.x からアップグレードする場合、コードを変更する必要はありません 。パッケージの依存関係を更新するだけで済みます。 この更新プログラムは、 インプロセス モデルを使用する Durable C# アプリを実行しているお客様にとって重大な変更と見なされます。

Azure Storage SDK の更新

既定では、Durable Functions Azure Storageをストレージ バックエンドとして使用して、アプリケーションの状態を永続的に保存します。 WebJobs.Extensions.DurableTask v3 では、Azure Storage バックエンドがアップグレードされ、Azure Storage SDK Azure の最新バージョンが使用されました。Data.Tables、Azure。Storage.Blobs、および Azure。Storage.Queues。 これらの SDK では、v2.x で使用される従来の Microsoft.Azure.Storage.* パッケージと比較して、マネージド ID のサポートが強化され、パフォーマンスが向上し、データ処理が効率的になり、セキュリティが向上します。

コスト効率の向上 (Azure Storage プロバイダー向け)

Azure Storage バックエンドでは、パーティション マネージャーはワーカー間で partitions/control キューを分散します。 WebJobs.Extensions.DurableTask v3 パッケージでは、既定で Partition Manager V3 が使用されます。これは、Azure テーブルを利用して、Azure Blob リースではなくパーティションの割り当てを管理する新しい設計です。 この設計により、デバッグを容易にしながら、ストレージ コストを大幅に削減できます。 Partition Manager V3 を使用すると、という名前のPartitionsがストレージ アカウントに作成されるため、パーティション情報を簡単に確認できます。

Azure Functions v1 ランタイムのサポートを削除しました

WebJobs.Extensions.DurableTask v3 では、Azure Functions ランタイムのバージョン 1.x がサポートされなくなりました。サポートは、September 2026 で終了するようにスケジュールされています。 Functions ランタイム v1 を使用する必要がある場合は、v2.11.0 より前の Durable Functions 拡張機能バージョンを使用してください。 スケジュールされたサポートが終了すると、Durable Functionsはランタイム v1 のサポートも削除されることに注意してください。

.NET ランタイム ターゲットの更新

WebJobs.Extensions.DurableTask v3 は、ターゲット ランタイムを .NET Core 3.1 から .NET 6 に更新し、最新の.NET機能とライブラリとのパフォーマンスの向上と互換性の強化を提供します。 この更新プログラムは、Azure Functions拡張機能バンドルの将来のリリースに合わせて調整されます。

v2.x から v3.x に移行する

v2.x から v3.x への移行にはコードの変更は必要ありません。新しい機能の使用を開始するために依存関係を更新するだけです。

互換性のダウングレード (v3.x から v2.x)

WebJobs.Extensions.DurableTask v3 では、v2 (UTF-8) と比較して、Azure Storage SDK (Base64) に対して異なるテキスト エンコードが使用されます。 v3.x から v2.x に戻す必要がある場合は、下位互換性を確保するために、次の最小バージョンを使用します。

v2.x のサポートとメンテナンス

WebJobs.Extensions.DurableTask v2.x は引き続きセキュリティ更新プログラムとバグ修正プログラムを受け取り、既存のアプリケーションの安全性と安定性を維持します。 ただし、すべての新機能と拡張機能は、v3.x にのみ追加されます。 このため、最新の機能と継続的な機能強化を利用するには、できるだけ早く WebJobs.Extensions.DurableTask v3 にアップグレードする必要があります。

v2.x で導入された機能

サポートされているすべての言語で、Durable Functions 2.x 以降で次の機能を使用できます。

永続エンティティ

Durable Functionsでは、エンティティをサポートし、durable エンティティと呼ばれる小さな状態を読み取って更新します。 オーケストレーター関数と同様に、エンティティ関数は特殊なトリガーの種類である エンティティ トリガーを持つ関数です。 オーケストレーター関数とは異なり、エンティティ関数には特定のコード制約はありません。 また、エンティティ関数では、制御フローを介して状態を表す暗黙的ではなく、明示的に状態が管理されます。

詳細については、 永続エンティティ に関する記事を参照してください。

堅牢なHTTP

Durable Functionsには、Durable HTTP 機能が含まれており、次のことが可能です。

• オーケストレーション関数から HTTP API を直接呼び出します (いくつかの制限事項が記載されています)。
• クライアント側の HTTP 202 状態の自動ポーリングを実装します。
• Azure マネージド ID の組み込みサポートを使用します。

詳細については、 HTTP 機能 に関する記事を参照してください。

1.x から 2.x に移行する

このセクションでは、既存のバージョン 1.x Durable Functionsをバージョン 2.x に移行して新機能を利用する方法について説明します。

Durable Functions拡張機能をアップグレードする

Durable Functions バインド拡張機能の最新の 2.x バージョンをプロジェクトにインストールします。

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.*, 5.0.0)"
    }
}

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.*, 5.0.0)"
    }
}

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.*, 5.0.0)"
    }
}

Durable Functions コードを更新する

Durable Functions 2.x では、いくつかの破壊的変更が導入されています。 Durable Functions 1.x アプリケーションは、コードを変更せずに Durable Functions 2.x と互換性がありません。 このセクションでは、バージョン 1.x 関数を 2.x にアップグレードするときに行う必要がある変更の一部を示します。

Host.json スキーマ

Durable Functions 2.x では、新しい host.json スキーマが使用されます。 1.x からの主な変更点は次のとおりです。

• "storageProvider" (および "azureStorage" サブセクション) を使用してストレージ固有の構成を行います。
• "tracing" トレースおよびログ記録の設定。
• "notifications" (および "eventGrid" サブセクション) を使用して Event Grid 通知を構成します。

詳細については、Durable Functions host.json リファレンス ドキュメントを参照してください。

既定のタスク ハブ名の変更

バージョン 1.x では、タスク ハブ名が host.jsonで指定されていない場合、既定では "DurableFunctionsHub" に設定されていました。 バージョン 2.x では、既定のタスク ハブ名は関数アプリの名前から派生するようになりました。 このため、2.x にアップグレードするときにタスク ハブ名を指定していない場合、コードは新しいタスク ハブで動作し、実行中のすべてのオーケストレーションでアプリケーションが処理されなくなります。 この問題を回避するには、タスク ハブ名を v1.x の既定の "DurableFunctionsHub" に明示的に設定するか、フライト内オーケストレーションの破壊的変更を処理する方法の詳細については、 ダウンタイムなしのデプロイ ガイダンス に従ってください。

イベント生成の変更点

Durable Functions 1.x では、raise イベント API を呼び出し、存在しないインスタンスを指定すると、サイレント エラーが発生しました。 2.x 以降では、存在しないオーケストレーションにイベントを発生させると、例外が発生します。

関連するコンテンツ

• インプロセスから分離ワーカー モデルへの移行
• Durable Functions の概要
• Durable Functions分離プロセスの概要