Přehled vazeb Azure SQL pro Azure Functions

Tato sada článků vysvětluje, jak pracovat s vazbami Azure SQL ve službě Azure Functions. Azure Functions podporuje vstupní vazby, výstupní vazby a trigger funkce pro produkty Azure SQL a SQL Server.

Akce Typ
Aktivace funkce při zjištění změny v tabulce SQL Trigger SQL
Čtení dat z databáze Vstupní vazba
Uložení dat do databáze Výstupní vazba

Instalace rozšíření

Balíček NuGet rozšíření, který nainstalujete, závisí na režimu jazyka C#, který používáte ve své aplikaci funkcí:

Funkce se spouštějí v izolovaném pracovním procesu C#. Další informace najdete v průvodci spuštěním služby Azure Functions v jazyce C# v izolovaném pracovním procesu.

Přidejte rozšíření do projektu instalací tohoto balíčku NuGet.

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Sql

Pokud chcete použít verzi Preview balíčku Microsoft.Azure.Functions.Worker.Extensions.Sql, přidejte --prerelease do příkazu příznak. Funkce Preview můžete zobrazit na stránce verze Rozšíření SQL pro Azure Functions.

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Sql --prerelease

Poznámka:

Zásadní změny mezi verzemi Preview vazeb Azure SQL pro Azure Functions vyžadují, aby všechny funkce, které cílí na stejnou databázi, používaly stejnou verzi balíčku rozšíření SQL.

Instalace sady

Pokud chcete v aplikaci použít toto rozšíření vazeb, ujistěte se, že soubor host.json v kořenovém adresáři projektu obsahuje tento extensionBundle odkaz:

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.0.0)"
    }
}

V tomto příkladu version hodnota [4.0.0, 5.0.0) dává hostiteli Functions pokyn, aby používal verzi sady, která je alespoň 4.0.0 , ale menší než 5.0.0, která zahrnuje všechny potenciální verze 4.x. Tato notace efektivně udržuje vaši aplikaci na nejnovější dostupné podverzi sady rozšíření v4.x.

Pokud je to možné, měli byste použít nejnovější hlavní verzi sady rozšíření a umožnit modulu runtime automaticky udržovat nejnovější podverzi. Obsah nejnovější sady můžete zobrazit na stránce verze sady rozšíření. Další informace najdete v sadách rozšíření Azure Functions.

Pokud vaše aplikace potřebuje používat funkce preview, měli byste místo toho odkazovat na nejnovější verzi sady Preview. Další informace najdete v tématu Práce se sadami rozšíření Preview.

Funkce Preview můžete zobrazit na stránce verze Rozšíření SQL pro Azure Functions.

Poznámka:

Zásadní změny mezi verzemi Preview vazeb Azure SQL pro Azure Functions vyžadují, aby všechny funkce, které cílí na stejnou databázi, používaly stejnou verzi balíčku rozšíření SQL.

Aktualizace balíčků

Přidejte balíček Azure Functions Java SQL Types do projektu funkcí s aktualizací pom.xml souboru v projektu, jak je znázorněno v tomto příkladu:

<dependency>
    <groupId>com.microsoft.azure.functions</groupId>
    <artifactId>azure-functions-java-library-sql</artifactId>
    <version>2.1.0</version>
</dependency>

Connections

Vlastnost connectionStringSetting je nastavena na klíč v nastavení aplikace, který vrací hodnotu používanou runtime Functions k připojení k databázi Azure SQL nebo SQL Server používané rozšířením. Hodnota nastavení vlastnosti spojení závisí na typu spojení:

  • Spravované identity connection: Vlastnost connectionStringSetting vrací připojovací řetězec, který používá Authentication=služba Active Directory Managed Identity autentizaci bez tajemství. Můžete použít spravovanou identitu přiřazenou systémem nebo spravovanou identitu přiřazenou uživatelem. Pro více informací viz Připojit funkční aplikaci k Azure SQL s řízenou identitou a Definovat spojení identity.
  • Key Vault reference: Nastavení connectionStringSetting vlastnosti vrací Azure Key Vault reference na místo, kde je připojovací řetězec centrálně udržován. Pro více informací viz Definujte spojení Key Vault.
  • App Configuration reference: Nastavení connectionStringSetting vlastnosti vrací referenci Azure App Configuration, která vrací připojovací řetězec nebo Key Vault reference. Pro více informací viz Azure App Configuration v článku o připojeních.
  • Connection string: Nastavení connectionStringSetting vlastnosti vrací skutečný SQL připojovací řetězec. Protože připojovací řetězec může obsahovat přihlašovací údaje, měli byste použít managed identity connection nebo alespoň uložit připojovací řetězec v Key Vault. Pro více informací viz Definujte souvislosti.

Chcete-li se dozvědět více o vazbách spojení, viz Správa spojení v Azure Functions.

připojovací řetězec je předán Microsoftu. Data.SqlClient a podporuje všechna klíčová slova definovaná v dokumentaci SqlClient ConnectionString. Mezi klíčová slova patří:

  • Authentication: Connect to Azure SQL with Microsoft Entra ID. Nastaveno na služba Active Directory Managed Identity pro spravované identity. Pro více informací viz Připojit funkční aplikaci k Azure SQL pomocí spravované identity.
  • Command Timeout: Čekejte stanovený čas v několika sekundách před ukončením dotazu (výchozí 30 sekund).
  • ConnectRetryCount: Automaticky provádět další pokusy o opětovné připojení, zejména pro serverless úroveň Azure SQL Database (výchozí 1).
  • Pooling: Opětovné použití spojení s databází pro zlepšení výkonu (výchozí true). Mezi další nastavení sdružování připojení patří Connection Lifetime, Max Pool Sizea Min Pool Size. Více informací najdete v dokumentaci ADO.NET.

Důležité informace

  • Vazba Azure SQL podporuje modul runtime Functions verze 4.x a novější.
  • Zdrojový kód pro vazby Azure SQL najdete v tomto úložišti GitHubu.
  • Tato vazba vyžaduje připojení k databázi Azure SQL nebo SQL Serveru.
  • Výstupní vazby pro tabulky se sloupci datových typů NTEXTnebo TEXTIMAGE nejsou podporované a upserty dat selžou. Tyto typy budou odebrány v budoucí verzi SQL Serveru a nebudou OPENJSON kompatibilní s funkcí používanou touto vazbou Azure Functions.
  • Používejte spravované identity místo uživatelských jmen a hesel.
  • Zvažte použití hodnoty klíče Azure k ukládání nastavení aplikace.

Ukázky

Kromě ukázek pro C#, Java, JavaScript, PowerShell a Python, které jsou k dispozici v úložišti GitHub vazeb Azure SQL, jsou k dispozici další možnosti v ukázkách Azure:

Další kroky

  • Last updated on