适用于 Azure Functions 的 Azure Blob 存储绑定概述

Azure Functions 通过触发器和绑定Azure 存储集成。 与 Blob 存储集成即可构建函数,用于响应 blob 数据中的更改以及读取和写入值。

操作 类型
在 blob 存储数据更改时运行函数 触发器
在函数中读取 blob 存储数据 输入绑定
允许函数写入 blob 存储数据 输出绑定

安装扩展

你安装的扩展 NuGet 包取决于你在函数应用中使用的 C# 模式:

函数在与函数主机相同的进程中执行。 若要了解详细信息,请参阅使用 Azure Functions 开发 C# 类库函数

扩展的功能因扩展版本而异:

此版本引入了使用标识而不是机密进行连接的功能。 有关使用托管标识配置函数应用的教程,请参阅使用基于标识的连接创建函数应用教程

此版本允许绑定到 Azure.Storage.Blobs 中的类型。 通过 Azure.Storage.Blobs 迁移指南详细了解这些新类型与 WindowsAzure.StorageMicrosoft.Azure.Storage 的不同之处以及如何迁移到这些类型。

可以通过安装 Microsoft.Azure.WebJobs.Extensions.Storage.Blobs NuGet 包版本 5.x 获得此扩展。

使用 .NET CLI:

dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage.Blobs --version 5.0.0

注意

Blob 存储、队列存储和表存储现在使用单独的扩展,并单独引用。 例如,若要在 .NET 进程内应用中为所有三个服务使用触发器和绑定,应将以下包添加到项目:

以前,这些扩展作为 Microsoft.Azure.WebJobs.Extensions.Storage 版本 4.x 一同交付。 此包还有一个 5.x 版本,该版本仅引用 Blob 和队列的拆分包。 因此,在从旧版本升级包引用时,可能需要额外引用新的 Microsoft.Azure.WebJobs.Extensions.Tables NuGet 包。 此外,在引用这些较新的拆分包时,请确保不要引用旧版组合存储包,否则会导致相同绑定的两种定义发生冲突。

安装捆绑包

Blob 存储绑定是在 host.json 项目文件中指定的扩展捆绑包的一部分。 你可能需要修改此捆绑包以更改绑定的版本,或者如果尚未安装捆绑包。 若要了解详细信息,请参阅扩展捆绑包

此版本引入了使用标识而不是机密进行连接的功能。 有关使用托管标识配置函数应用的教程,请参阅使用基于标识的连接创建函数应用教程

可以通过在 host.json 文件中添加或替换以下代码,从扩展捆绑包 v3 添加该扩展的这一版本:

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[3.3.0, 4.0.0)"
    }
}

若要了解详细信息,请参阅更新扩展

注意

3.x 版扩展捆绑包目前不包含表存储绑定。 目前,如果应用需要表存储,则需继续使用 2.x 版。

host.json 设置

本部分介绍使用此绑定函数的函数应用程序配置设置。 这些设置仅在使用扩展版本 5.0.0 及更高版本时才适用。 下面的示例 host.json 文件仅包含此绑定的 2.x 版及更高版本设置。 若要详细了解版本 2.x 及更高版本中的函数应用程序配置设置,请参阅 Azure Functions 的 host.json 参考

注意

本部分不适用于 5.0.0 之前的扩展版本。 对于这些早期版本,没有任何适用于 Blob 的函数应用范围的配置设置。

{
    "version": "2.0",
    "extensions": {
        "blobs": {
            "maxDegreeOfParallelism": 4
        }
    }
}
属性 默认 说明
maxDegreeOfParallelism 8 *(可用核心数) 每个 blob 触发器函数允许使用的并发调用数(整数)。 允许的最小值为 1。

后续步骤