Azure Functions：绑定到 DocumentClient 与静态实例 - 推荐什么？

我知道如何将查询直接绑定到 Azure 函数并在函数中使用 Cosmos DB 触发器。

但是，我正在寻找使用方向DocumentClient（努吉特包Microsoft.Azure.Cosmos） 直接地。

1. There's 文档这解释了如何在执行之间重用静态客户端实例。
2. 也可以获得DocumentClient通过添加实例作为绑定[DocumentDB("test", "test", ConnectionStringSetting = "CosmosDB")] DocumentClient client到函数的参数。
3. 最后，可以创建一个DocumentClient函数体内的实例：var client = new DocumentClient(...).

我没有找到明确的建议何时使用什么方法，只是由于性能、内存使用和连接限制，第 3 种方法从来都不是一个好的选择。另外，我知道使用静态实例有优点。

问题

• Azure 函数有连接限制（在这里讨论）。使用方法 2（绑定到客户端）时这是否也适用？
• 使用方法 2（绑定）与方法 1（静态）相比有何优缺点？
• 与绑定到 SQL 查询相比，绑定到 SQL 查询有什么优势？DocumentClient并在函数体内创建查询？

还有另一种使用 DocumentClient 的方法。 从 Microsoft.NET.Sdk.Functions 版本 1.0.28 开始，现在可以使用 FunctionsStartup 类初始化 DocumentClient 一次，然后将其注册为 DI（依赖注入），然后每次都使用相同的实例。

FunctionsStartup 类已记录here。更好的解释是here.

在 Startup 的配置方法中，构建您的客户端。

using Microsoft.Azure.Functions.Extensions.DependencyInjection;
using Microsoft.Extensions.DependencyInjection;
[assembly: FunctionsStartup(typeof(MyApp.Startup))]
namespace MyApp
{
    public class Startup : FunctionsStartup
    {
        public override void Configure(IFunctionsHostBuilder builder)
        {
            IDocumentClient client = GetCustomClient();
            builder.Services.AddSingleton<IDocumentClient>(client);
        }
}

然后可以将其注入到函数构造函数中并由方法使用。

public class MyFunction
{
    private IDocumentClient _client;

    public MyFunction(IDocumentClient client)
    {
        _client = client;
    }

    [FunctionName("MyFunction")]
    public async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = null)] HttpRequest req,
        ILogger log)
    {
        // use _client here.
    }
}

当 Azure 创建此类的实例来服务请求时，它会传递在 FunctionsStartup 类中创建的 IDocumentClient 实例。

这一策略允许重复使用同一 DocumentClient 实例。这个客户端的单一性不是通过使其静态来强制的，而是通过确保我们只创建它一次。这也有助于提高可测试性，因为测试可以注入 IDocumentClient 的不同实例。