管理 Azure Functions 中的連線

函數應用程式共用資源中的函數。 這些共用資源為連線：HTTP 連線、資料庫連線，以及 Azure 儲存體等服務連線。 當許多函數同時在使用量方案中執行時，就可能用盡可用的連線。 本文說明如何避免使用其所需的更多連線來撰寫函數的程式碼。

注意

本文所述的連線限制僅適用於在使用量方案中執行時。 不過，在此所述的技術可能會在任何方案中執行時有所幫助。

連線限制

使用量方案中可用的連線數目有限，部分原因為此方案中的函數應用程式會在沙箱環境中執行。 沙箱對程式碼施加的其中一項限制是輸出連線數目的限制，也就是目前每個執行個體 600 個 (共 1,200 個) 連線。 當您到達此限制時，函數執行階段會將下列訊息寫入記錄：Host thresholds exceeded: Connections。 如需詳細資訊，請參閱函數服務限制。

此限制是按執行個體。 當調整控制器新增函數應用程式執行個體來處理更多要求時，每個執行個體都有獨立的連線限制。 這表示沒有全域連線限制，而且在所有作用中執行個體上可以有超過 600 個作用中的連線。

進行疑難排解時，請確定您已為函數應用程式啟用 Application Insights。 Application Insights 可讓您檢視函數應用程式的計量，例如執行。 如需詳細資訊，請參閱檢視 Application Insights 中的遙測。

靜態用戶端

若要避免保有超過所需的連線，請重複使用用戶端執行個體，而不是在每次函式引動過程建立新的執行個體。 建議您針對任何可能用來撰寫函數的語言重複使用用戶端連線。 如果您使用單一靜態用戶端，則 .NET 用戶端 (HttpClient、DocumentClient 和 Azure 儲存體用戶端) 可以管理連線。

以下是在 Azure Functions 應用程式中使用特定服務用戶端時所要遵循的一些指導方針：

• 請勿在每次函數叫用過程建立新的用戶端。
• 請建立單一靜態用戶端，以供每次函數叫用使用。
• 如果不同函數使用相同的服務，請考慮在共用協助程式類別中建立單一靜態用戶端。

用戶端程式碼範例

本節示範如何從您的函式程式碼建立和使用用戶端的最佳做法。

HTTP 要求

C#

以下 C# 函式程式碼範例會建立靜態 HttpClient 執行個體：

// 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 的物件後，您可以將其捨棄。 但您不會處置靜態用戶端，因為在函數結束時，您還未使用完畢。 您希望靜態用戶端在您應用程式的使用期間存留。

JavaScript

因為它提供更好的連線管理選項，所以您應該使用原生的 http.agent 類別而不是非原生的方法，例如 node-fetch 模組。 連線參數是透過 http.agent 類別上的選項來設定的。 如需使用 HTTP 代理程式提供的詳細選項，請參閱新的 Agent([options])。

http.request() 所使用的全域 http.globalAgent 類別會將這些值全都設定為其各自的預設值。 在 Functions 中設定連線限制的建議方式是全域設定最大數目。 下列範例會針對函式應用程式設定通訊端數目上限：

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);

Azure Cosmos DB 用戶端

C#

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.com: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>

JavaScript

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);
}

SqlClient 連線

函數程式碼可能會使用 .NET Framework Data Provider for SQL Server (SqlClient) 來連線到 SQL 關聯式資料庫。 這也是依賴 ADO.NET 之資料架構的基礎提供者，例如 Entity Framework。 不同於 HttpClient \(英文\) 和 DocumentClient \(英文\) 連線，ADO.NET 預設會實作連線共用。 不過，由於您仍然可將連線用完，因此，您應該將與資料庫的連線最佳化。 如需詳細資訊，請參閱 SQL Server 連線共用 (ADO.NET) \(機器翻譯\)。

提示

部分資料架構 (例如 Entity Framework) 通常會從設定檔的 ConnectionStrings 區段取得連接字串。 在此情況下，您必須明確地將 SQL 資料庫連接字串新增至函數應用程式設定的連接字串集合，以及您本機專案的 local.settings.json 檔案中。 如果您要在函數程式碼中建立 SqlConnection 執行個體，您應該將連接字串值以及其他連線一起儲存於應用程式設定中。

下一步

如需有關為何建議使用靜態用戶端的詳細資訊，請參閱不適當的具現化反模式。

如需更多 Azure Functions 效能祕訣，請參閱將 Azure Functions 效能和可靠性最佳化。