管理 Azure Functions 中的连接

下面是用于创建静态 HttpClient 实例的 C# 函数代码示例：

// Create a single, static HttpClient
private static HttpClient httpClient = new HttpClient();

public static async Task Run(string input)
{
    var response = await httpClient.GetAsync("https://example.com");
    // Rest of function
}

关于 .NET 中 HttpClient 的一个常见问题是“我应该释放我的客户端吗？”通常在使用完实现 IDisposable 的对象后将其释放。 但是，你不会释放静态客户端，因为在函数结束后还需要使用它。 你需要将静态客户端一直保留到应用程序生存期结束。

因为它提供了更好的连接管理选项，所以你应当使用本机 http.agent 类而不应当使用非本机方法，例如 node-fetch 模块。 连接参数通过 http.agent 类上的选项配置。 有关 HTTP 代理的可用详细选项，请参阅 new Agent([options])。

http.request() 使用的全局 http.globalAgent 类将这些值全部设置为各自的默认值。 在 Functions 中配置连接限制的建议方法是全局设置一个最大数量。 以下示例为函数应用设置最大 socket 数量：

http.globalAgent.maxSockets = 200;

以下示例创建一个新的 HTTP 请求，并采用仅用于该请求的自定义 HTTP 代理：

var http = require('http');
var httpAgent = new http.Agent();
httpAgent.maxSockets = 200;
const options = { agent: httpAgent };
http.request(options, onResponseCallback);

CosmosClient 连接到 Azure Cosmos DB 实例。 Azure Cosmos DB 文档建议在应用程序生存期内使用单一实例 Azure Cosmos DB 客户端。 以下示例展示了在函数中执行该操作的一种模式：

#r "Microsoft.Azure.Cosmos"
using Microsoft.Azure.Cosmos;

private static Lazy<CosmosClient> lazyClient = new Lazy<CosmosClient>(InitializeCosmosClient);
private static CosmosClient cosmosClient => lazyClient.Value;

private static CosmosClient InitializeCosmosClient()
{
    // Perform any initialization here
    var uri = "https://youraccount.documents.azure.cn:443";
    var authKey = "authKey";
   
    return new CosmosClient(uri, authKey);
}

public static async Task Run(string input)
{
    Container container = cosmosClient.GetContainer("database", "collection");
    MyItem item = new MyItem{ id = "myId", partitionKey = "myPartitionKey", data = "example" };
    await container.UpsertItemAsync(document);
   
    // Rest of function
}

同时，为触发器创建一个名为“function.proj”的文件，并添加以下内容：

<Project Sdk="Microsoft.NET.Sdk">
    <PropertyGroup>
        <TargetFramework>netcoreapp3.1</TargetFramework>
    </PropertyGroup>
    <ItemGroup>
        <PackageReference Include="Microsoft.Azure.Cosmos" Version="3.23.0" />
    </ItemGroup>
</Project>

CosmosClient 连接到 Azure Cosmos DB 实例。 Azure Cosmos DB 文档建议在应用程序生存期内使用单一实例 Azure Cosmos DB 客户端。 以下示例展示了在函数中执行该操作的一种模式：

const cosmos = require('@azure/cosmos');
const endpoint = process.env.COSMOS_API_URL;
const key = process.env.COSMOS_API_KEY;
const { CosmosClient } = cosmos;

const client = new CosmosClient({ endpoint, key });
// All function invocations also reference the same database and container.
const container = client.database("MyDatabaseName").container("MyContainerName");

module.exports = async function (context) {
    const { resources: itemArray } = await container.items.readAll().fetchAll();
    context.log(itemArray);
}