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을 구현하는 개체를 삭제합니다. 그러나 함수가 끝날 때 사용이 완료되지 않기 때문에 정적 클라이언트를 삭제하지 않습니다. 정적 클라이언트가 애플리케이션 기간 동안 지속되도록 합니다.

개선된 연결 관리 옵션을 제공하므로 비네이티브 메서드 대신 node-fetch 모듈과 같이 네이티브 http.agent 클래스를 사용해야 합니다. 연결 매개변수는 http.agent 클래스의 옵션을 통해 구성됩니다. HTTP 에이전트에서 사용할 수 있는 자세한 옵션은 새 에이전트([옵션])를 참조하세요.

http.request()에서 사용하는 전체 http.globalAgent 클래스에는 이러한 모든 값이 해당 기본값으로 설정되어 있습니다. 함수에서 연결 제한을 구성하는 방법은 최대 수를 전역적으로 설정하는 것이 좋습니다. 다음 예제에서는 함수 앱에 대한 소켓의 최대 수를 설정합니다.

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

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