适用于 Azure Functions 的 Azure 表绑定

函数在独立的 C# 工作进程中执行。 若要了解详细信息，请参阅有关在独立工作进程中运行 C# Azure Functions 的指南。

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

在此模型的变体中，可以使用 C# 脚本运行 Functions，该脚本主要用于 C# 门户编辑。 若要更新在门户中运行的 C# 脚本应用程序的现有绑定扩展，而无需重新发布函数应用，请参阅更新扩展。

本节介绍如何使用类库。 对于 C# 脚本，需要改为安装扩展捆绑包版本 4.x。

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

此版本允许绑定到 Azure.Data.Tables 中的类型。 它还引入了使用 Azure Cosmos DB for Table 的功能。

通过将 Microsoft.Azure.WebJobs.Extensions.Tables NuGet 包安装到使用 Blob 和队列扩展的 5.x 或更高版本的项目，可以使用此扩展。

使用 .NET CLI：

# Install the Azure Tables extension
dotnet add package Microsoft.Azure.WebJobs.Extensions.Tables

# Update the combined Azure Storage extension (to a version which no longer includes Azure Tables)
dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage

本节介绍如何使用类库。 对于 C# 脚本，需要改为安装扩展捆绑包版本 2.x。

使用绑定需要引用相应的 NuGet 包。 表包含在 Azure 存储的组合包中。 安装 Microsoft.Azure.WebJobs.Extensions.Storage NuGet 包版本 3.x 或 4.x。

Functions 1.x 应用会自动引用 Microsoft.Azure.WebJobs NuGet 程序包（版本 2.x）。

在 Functions 1.x 中，存储触发器和绑定使用 Azure 存储 SDK 版本 7.2.1（WindowsAzure.Storage NuGet 包）。 如果引用不同版本的存储 SDK 并绑定到函数签名中的一种存储 SDK 类型，Functions 运行时可能报告无法绑定到该类型。 解决办法是确保项目引用 WindowsAzure.Storage 7.2.1。

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

此版本允许绑定到 Azure.Data.Tables 中的类型。 它还引入了使用 Azure Cosmos DB for Table 的功能。

通过将 Microsoft.Azure.Functions.Worker.Extensions.Tables NuGet 包安装到使用 Blob 和队列扩展的 5.x 或更高版本的项目，可以使用此扩展。

使用 .NET CLI：

# Install the Azure Tables extension
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Tables --version 1.0.0

# Update the combined Azure Storage extension (to a version which no longer includes Azure Tables)
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Storage --version 5.0.0

如果要使用 F# 编写应用程序，则还必须将此扩展配置为应用的启动配置的一部分。 在对 ConfigureFunctionsWorkerDefaults() 或 ConfigureFunctionsWebApplication() 的调用中，添加接受 IFunctionsWorkerApplication 参数的委托。 然后在该委托的正文中，在对象上调用 ConfigureTablesExtension()：

let hostBuilder = new HostBuilder()
hostBuilder.ConfigureFunctionsWorkerDefaults(fun (context: HostBuilderContext) (appBuilder: IFunctionsWorkerApplicationBuilder) ->
    appBuilder.ConfigureTablesExtension() |> ignore
) |> ignore

表包含在 Azure 存储的组合包中。 安装 Microsoft.Azure.Functions.Worker.Extensions.Storage NuGet 包版本 4.x。

Functions 版本 1.x 不支持独立工作进程。

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

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

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

可以通过注册扩展捆绑包版本 2.x 在函数应用中安装此版本的扩展。

Functions 1.x 应用自动具有对扩展的引用。

独立工作进程类库的已编译 C# 函数在独立于运行时的进程中运行。

进程内类库是编译的 C# 函数，该函数在与 Functions 运行时相同的进程中运行。

Azure 表扩展支持下表所示的参数类型。

早期版本的扩展公开了现已弃用的 Microsoft.Azure.Cosmos.Table 命名空间中的类型。 Azure.Data.Tables 中的较新类型专用于 Azure 表扩展。

此版本的扩展支持下表所示的参数类型。

Functions 1.x 公开了已弃用的 Microsoft.WindowsAzure.Storage.Table 命名空间中的类型。 Azure.Data.Tables 中的较新类型专用于 Azure 表扩展。 若要使用这些版本，需要将应用程序升级到 Functions 4.x。

独立工作进程支持下表所示的参数类型。 对绑定到 Azure.Data.Tables 中类型的支持目前处于预览阶段。

Azure 表输入绑定

使用单个表实体时，Azure 表输入绑定可以绑定到以下类型：

如果使用查询中的多个实体，可将 Azure 表输入绑定绑到以下类型：

¹ 若要使用这些类型，需要引用 Microsoft.Azure.Functions.Worker.Extensions.Tables 1.2.0-preview1 或更高版本以及 SDK 类型绑定的常见依赖项。

Azure 表输出绑定

如果希望函数写入单个实体，Azure 表输出绑定可以绑定到以下类型：

如果希望函数写入多个实体，Azure 表输出绑定可以绑定到以下类型：

对于其他输出方案，请直接创建和使用 Azure.Data.Tables 中的类型。

独立工作进程中扩展的早期版本仅支持绑定到普通旧 CLR 对象 (POCO) 类型。 Azure 表扩展提供了其他选项。

Functions 版本 1.x 不支持独立工作进程。 若要使用独立辅助角色模型，请将应用程序升级到 Functions 4.x。