Azure İşlevleri'nde bağlantıları yönetme

İşlev uygulamasındaki işlevler kaynakları paylaşır. Bu paylaşılan kaynaklar arasında bağlantılar vardır: HTTP bağlantıları, veritabanı bağlantıları ve Azure Depolama gibi hizmetlere yapılan bağlantılar. Tüketim planında birçok işlev eşzamanlı olarak çalıştırıldığında, kullanılabilir bağlantıların tükenmiş olması mümkündür. Bu makalede, işlevlerinizi ihtiyaç duyduklarından daha fazla bağlantı kullanmaktan kaçınmak için nasıl kodladıklarınız açıklanmaktadır.

Not

Bu makalede açıklanan bağlantı sınırları yalnızca Tüketim planında çalıştırılırken geçerlidir. Ancak, burada açıklanan teknikler herhangi bir plan üzerinde çalışırken yararlı olabilir.

Bağlantı sınırı

Tüketim planındaki kullanılabilir bağlantı sayısı kısmen sınırlıdır çünkü bu plandaki bir işlev uygulaması korumalı alan ortamında çalışır. Korumalı alanın kodunuz üzerinde uyguladığı kısıtlamalardan biri, şu anda örnek başına 600 etkin (toplam 1.200) bağlantı olan giden bağlantı sayısı sınırıdır. Bu sınıra ulaştığınızda, işlevler çalışma zamanı günlüklere şu iletiyi yazar: Host thresholds exceeded: Connections. Daha fazla bilgi için bkz . İşlevler hizmet sınırları.

Bu sınır örnek başınadır. Ölçek denetleyicisi daha fazla isteği işlemek için işlev uygulaması örnekleri eklediğinde , her örneğin bağımsız bir bağlantı sınırı vardır. Başka bir deyişle genel bağlantı sınırı yoktur ve tüm etkin örneklerde 600'den fazla etkin bağlantınız olabilir.

Sorun giderme sırasında, işlev uygulamanız için Application Insights'ı etkinleştirdiğinizden emin olun. Application Insights, yürütmeler gibi işlev uygulamalarınız için ölçümleri görüntülemenizi sağlar. Daha fazla bilgi için bkz. Application Insights'ta telemetriyi görüntüleme.

Statik istemciler

Gerekenden daha fazla bağlantı tutmaktan kaçınmak için, her işlev çağrısıyla yenilerini oluşturmak yerine istemci örneklerini yeniden kullanın. İşlevinizi yazabileceğiniz herhangi bir dil için istemci bağlantılarını yeniden kullanmanızı öneririz. Örneğin, HttpClient, DocumentClient ve Azure Depolama istemcileri gibi .NET istemcileri, tek bir statik istemci kullanıyorsanız bağlantıları yönetebilir.

Azure İşlevleri uygulamasında hizmete özgü bir istemci kullanırken izleyebileceğiniz bazı yönergeler şunlardır:

• Her işlev çağrısıyla yeni bir istemci oluşturmayın.
• Her işlev çağrısının kullanabileceği tek bir statik istemci oluşturun.
• Farklı işlevler aynı hizmeti kullanıyorsa, paylaşılan bir yardımcı sınıfında tek bir statik istemci oluşturmayı göz önünde bulundurun.

İstemci kodu örnekleri

Bu bölümde, işlev kodunuzdan istemci oluşturmaya ve kullanmaya yönelik en iyi yöntemler gösterilmektedir.

HTTP istekleri

C#

Burada statik httpclient örneği oluşturan bir C# işlev kodu örneği verilmiştir:

// 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'te HttpClient ile ilgili yaygın bir soru şudur: "İstemcimi atayım mı?" Genel olarak, bunları kullanmayı bitirdiğinizde uygulanan IDisposable nesneleri atabilirsiniz. Ancak statik istemciyi atmazsınız çünkü işlev sona erdiğinde bu istemciyi kullanmayı bitirmezsiniz. Statik istemcinin uygulamanızın süresi boyunca yaşamasını istiyorsunuz.

JavaScript

Daha iyi bağlantı yönetimi seçenekleri sağladığından, modül gibi node-fetch yerel http.agent olmayan yöntemler yerine yerel sınıfı kullanmanız gerekir. Bağlantı parametreleri, sınıfındaki http.agent seçenekler aracılığıyla yapılandırılır. HTTP aracısı ile kullanılabilen ayrıntılı seçenekler için bkz. yeni Aracı([seçenekler]).

tarafından http.request() kullanılan genel http.globalAgent sınıfın tüm bu değerleri ilgili varsayılan değerlerine ayarlanmıştır. İşlevler'de bağlantı sınırlarını yapılandırmanın önerilen yolu, genel olarak en yüksek sayıyı ayarlamaktır. Aşağıdaki örnek, işlev uygulaması için en fazla yuva sayısını ayarlar:

http.globalAgent.maxSockets = 200;

Aşağıdaki örnek, yalnızca bu istek için özel bir HTTP aracısı ile yeni bir HTTP isteği oluşturur:

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

Azure Cosmos DB istemcileri

C#

CosmosClient bir Azure Cosmos DB örneğine bağlanır. Azure Cosmos DB belgeleri, uygulamanızın ömrü boyunca tekil bir Azure Cosmos DB istemcisi kullanmanızı önerir. Aşağıdaki örnekte, bir işlevde bunu yapmaya yönelik bir desen gösterilmektedir:

#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
}

Ayrıca tetikleyiciniz için "function.proj" adlı bir dosya oluşturun ve aşağıdaki içeriği ekleyin:

<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 bir Azure Cosmos DB örneğine bağlanır. Azure Cosmos DB belgeleri, uygulamanızın ömrü boyunca tekil bir Azure Cosmos DB istemcisi kullanmanızı önerir. Aşağıdaki örnekte, bir işlevde bunu yapmaya yönelik bir desen gösterilmektedir:

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 bağlantıları

İşlev kodunuz, SQL Server için .NET Framework Veri Sağlayıcısı'nı (SqlClient) kullanarak SQL ilişkisel veritabanına bağlantı oluşturabilir. Bu, Entity Framework gibi ADO.NET kullanan veri çerçeveleri için de temel alınan sağlayıcıdır. HttpClient ve DocumentClient bağlantılarından farklı olarak, ADO.NET varsayılan olarak bağlantı havuzu uygular. Ancak yine de bağlantınız tükenebileceğinden, veritabanı bağlantılarını iyileştirmeniz gerekir. Daha fazla bilgi için bkz. SQL Server Bağlantı Havuzu (ADO.NET).

İpucu

Entity Framework gibi bazı veri çerçeveleri genellikle bir yapılandırma dosyasının ConnectionStrings bölümünden bağlantı dizeleri alır. Bu durumda, SQL veritabanı bağlantı dizelerini işlev uygulaması ayarlarınızın Bağlantı dizeleri koleksiyonuna ve yerel projenizdeki local.settings.json dosyasına açıkça eklemeniz gerekir. İşlev kodunuzda bir SqlConnection örneği oluşturuyorsanız, bağlantı dizesi değerini diğer bağlantılarınızla birlikte Uygulama ayarlarında depolamanız gerekir.

Sonraki adımlar

Statik istemcileri neden önerdiğimiz hakkında daha fazla bilgi için bkz . Yanlış örnek oluşturma kötü modeli.

Daha fazla Azure İşlevleri performans ipucu için bkz. Azure İşlevleri performansını ve güvenilirliğini iyileştirme.