Durable Functions 版本概述

Durable Functions 是 Azure FunctionsAzure WebJobs 的扩展,可用于在无服务器环境中编写有状态函数。 该扩展可用于管理状态、检查点和重启。 如果你不熟悉 Durable Functions,请参阅概述文档

2.x 中的新功能

此部分介绍在 2.x 版中添加的 Durable Functions 功能。

持久实体

在 Durable Functions 2.x 中,我们引入了一个新的实体函数概念。

实体函数定义用于读取和更新较小状态片段(称为“持久实体”)的操作。 与业务流程协调程序函数类似,实体函数是具有特殊触发器类型“实体触发器”的函数。 与业务流程协调程序函数不同,实体函数没有任何特定的代码约束。 实体函数还会显式管理状态,而不是通过控制流隐式表示状态。

有关详细信息,请参阅持久实体一文。

持久 HTTP

在 Durable Functions 2.x 中,我们引入了新的持久 HTTP 功能,该功能允许你:

  • 直接从业务流程函数调用 HTTP API(有一些记录的限制)。
  • 实现自动客户端 HTTP 202 状态轮询。
  • Azure 托管标识的内置支持。

若要了解更多信息,请参阅 HTTP 功能一文。

从 1.x 迁移到 2.x

此部分介绍如何将现有的 1.x 版 Durable Functions 迁移到 2.x 版,以便利用新功能。

升级扩展

在项目中安装最新的 2.x 版 Durable Functions 绑定扩展。

JavaScript、Python 和 PowerShell

Durable Functions 2.x 在 Azure Functions 扩展包的版本 2.x 中可用。

需具备 Durable Functions 2.x 才能获得 Durable Functions 中的 Python 支持。

若要更新项目中的扩展包版本,请打开 host.json 并更新 extensionBundle 部分以使用版本 2.x ([2.*, 3.0.0))。

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

备注

如果在更改扩展捆绑版本后,Visual Studio Code 未显示正确的模板,请通过运行 Developer:Reload Window 命令(在 Windows 和 Linux 上为Ctrl + R,在 macOS 上为 Command + R)来重新加载窗口。

.NET

更新 .NET 项目以使用最新版本的 Durable Functions 绑定扩展

有关详细信息,请参阅注册 Azure Functions 绑定扩展

更新代码

Durable Functions 2.0 引入了几项中断性变更。 Durable Functions 1.x 应用程序在不更改代码的情况下预期不兼容 Durable Functions 2.x。 此部分列出了在将 1.x Functions 升级到 2.x 时必须完成的部分更改。

Host.json 架构

Durable Functions 2.x 使用新的 host.json 架构。 基于 1.x 的主要更改如下:

  • 存储特定的配置的 "storageProvider"(和 "azureStorage" 子节)。
  • 用于跟踪和记录配置的 "tracing"
  • 适用于事件网格通知配置的 "notifications"(和 "eventGrid" 子节)。

有关详细信息,请参阅 Durable Functions host.json 参考文档

默认的任务中心名称更改

在版本 1.x 中,如果未在 host.json 中指定任务中心名称,则该名称默认为“DurableFunctionsHub”。 在版本 2.x 中,默认的任务中心名称现在派生自函数应用的名称。 因此,如果在升级到 2.x 时未指定任务中心名称,则代码会使用新的任务中心进行操作,并且所有正在进行的业务流程将不再有处理它们的应用程序。 若要解决此情况,可以显式将任务中心名称设置为 v1.x 默认值“DurableFunctionsHub”,也可以参阅我们的零停机部署指南,详细了解如何处理正在进行的业务流程的中断性变更。

公共接口更改(仅 .NET)

在 1.x 版中,Durable Functions 支持的各种“上下文”对象包含适合在单元测试中使用的抽象基类。 作为 Durable Functions 2.x 的一部分,这些抽象基类由接口取代。

下表显示了主要更改:

1.x 2.x
DurableOrchestrationClientBase IDurableOrchestrationClientIDurableClient
DurableOrchestrationContextDurableOrchestrationContextBase IDurableOrchestrationContext
DurableActivityContextDurableActivityContextBase IDurableActivityContext
OrchestrationClientAttribute DurableClientAttribute

如果抽象基类包含虚拟方法,则这些虚拟方法已由 DurableContextExtensions 中定义的扩展方法取代。

function.json 更改(JavaScript 和 C# Script)

在 Durable Functions 1.x 中,业务流程客户端使用的 typeorchestrationClient。 2.x 版改用 durableClient

引发事件更改

在 Durable Functions 1.x 中,调用引发事件 API 并指定不存在的实例会导致静默失败。 从 2.x 开始,将事件引发到不存在的业务流程会导致异常。