Přehled vazeb Azure SQL pro Azure Functions

  • Článek

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

Rozšíření vazeb SQL je součástí sady rozšíření v4, která je zadaná v souboru projektu host.json.

Sada rozšíření je určena následujícím kódem v host.json souboru:

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

Modul runtime služby Functions

Instalace sady

Rozšíření vazeb SQL je součástí sady rozšíření v4, která je zadaná v souboru projektu host.json.

Sada rozšíření je určena následujícím kódem v host.json souboru:

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

Instalace sady

Rozšíření vazeb SQL je součástí sady rozšíření v4, která je zadaná v souboru projektu host.json.

Sada rozšíření je určena následujícím kódem v host.json souboru:

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

Aktualizace balíčků

Do projektu funkcí přidejte knihovnu Java pro vazby SQL s aktualizací pom.xml souboru v projektu Azure Functions v Javě, jak je vidět v následujícím fragmentu kódu:

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

Sadu rozšíření Preview můžete použít s aktualizací pom.xml souboru v projektu Azure Functions v Javě, jak je vidět v následujícím fragmentu kódu:

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

SQL připojovací řetězec

Vazby Azure SQL pro Azure Functions mají požadovanou vlastnost pro připojovací řetězec pro všechny vazby a triggery. Tyto předávají připojovací řetězec do knihovny Microsoft.Data.SqlClient a podporují připojovací řetězec, jak je definováno v dokumentaci k Připojení ionString SqlClient. Mezi klíčová slova patří:

  • Authentication umožňuje funkci připojit se k Azure SQL pomocí ID Microsoft Entra, včetně spravované identity Active Directory.
  • Command Timeout umožňuje funkci čekat na zadanou dobu v sekundách před ukončením dotazu (výchozí 30 sekund).
  • ConnectRetryCount umožňuje funkci automaticky provést další pokusy o opětovné připojení, zejména pro bezserverovou úroveň Azure SQL Database (výchozí 1).
  • Pooling umožňuje funkci opakovaně používat připojení k databázi, což může zlepšit výkon (výchozí true). Mezi další nastavení sdružování připojení patří Connection Lifetime, Max Pool Sizea Min Pool Size. Další informace o sdružování připojení najdete v dokumentaci k 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.

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