Översikt över Azure SQL-bindningar för Azure Functions

Den här uppsättningen artiklar beskriver hur du arbetar med Azure SQL-bindningar i Azure Functions. Azure Functions stöder indatabindningar, utdatabindningar och en funktionsutlösare för Azure SQL- och SQL Server-produkterna.

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

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

dotnet add package Microsoft.Azure.WebJobs.Extensions.Sql

dotnet add package Microsoft.Azure.WebJobs.Extensions.Sql --prerelease

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

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

Connections

Egenskapen connectionStringSetting är inställd på en nyckel i applikationsinställningarna som returnerar ett värde som används av Functions-runtimen för att ansluta till Azure SQL- eller SQL Server-databasen som används av tillägget. Värdet på anslutningsegenskapsinställningen beror på typen av anslutning:

• Managed identity connection: Egenskapen connectionStringSetting returnerar en reťazec pripojenia som används Authentication=služba Active Directory Managed Identity för autentisering utan hemligheter. Du kan använda antingen en systemtilldelad eller användartilldelad hanterad identitet. För mer information, se Koppla en funktionsapp till Azure SQL med hanterad identitet och Definiera identitetsanslutningar.
• Key Vault-referens: Egendomsinställningen connectionStringSetting returnerar en Azure Key Vault-referens till platsen där reťazec pripojenia underhålls centralt. För mer information, se Definiera Key Vault-anslutningar.
• App Configuration Reference: Egenskapsinställningen connectionStringSetting returnerar en Azure App Configuration-referens som returnerar en reťazec pripojenia eller en Key Vault-referens. För mer information, se Azure App Configuration i artikeln om anslutningar.
• Connection string: Egenskapsinställningen connectionStringSetting returnerar den faktiska SQL-reťazec pripojenia. Eftersom reťazec pripojenia kan innehålla referenser bör du använda en managed identity connection eller åtminstone lagra reťazec pripojenia i Key Vault. För mer information, se Definiera kopplingar.

För att lära dig mer om bindningsanslutningar, se Hantera anslutningar i Azure Functions.

reťazec pripojenia skickas vidare till Microsoft. Data.SqlClient och stöder alla nyckelord som definieras i dokumentationen SqlClient ConnectionString. Viktiga nyckelord är:

• Authentication: Anslut till Azure SQL med Microsoft Entra ID. Ställ in på služba Active Directory Managed Identity för managed identitys. För mer information, se Koppla en funktionsapp till Azure SQL med hanterad identitet.
• Command Timeout: Vänta en viss tid i sekunder innan du avslutar en fråga (standard 30 sekunder).
• ConnectRetryCount: Gör automatiskt ytterligare återanslutningsförsök, särskilt tillämpligt på Azure SQL Database serverless tier (standard 1).
• Pooling: Återanvänd anslutningar till databasen för att förbättra prestandan (standard true). Ytterligare inställningar för anslutningspooler är Connection Lifetime, Max Pool Sizeoch Min Pool Size. Läs mer i ADO.NET-dokumentationen.

Att tänka på

• Azure SQL-bindning stöder version 4.x och senare av Functions-körningen.
• Källkod för Azure SQL-bindningar finns på den här GitHub-lagringsplatsen.
• Den här bindningen kräver anslutning till en Azure SQL- eller SQL Server-databas.
• Utdatabindningar mot tabeller med kolumner med datatyper NTEXT, TEXTeller IMAGE stöds inte och datauppserterter misslyckas. Dessa typer tas bort i en framtida version av SQL Server och är inte kompatibla med funktionen OPENJSON som används av den här Azure Functions-bindningen.
• Använd hanterade identiteter i stället för användarnamn och lösenord.
• Överväg att använda ett Azure Key Value för att lagra programinställningar.

Exempel

Utöver exemplen för C#, Java, JavaScript, PowerShell och Python som är tillgängliga på GitHub-lagringsplatsen för Azure SQL-bindningar finns det fler tillgängliga i Azure-exempel:

• ToDo API sample with Azure SQL bindings (C#)
• Använda SQL-bindningar i Azure Stream Analytics

Nästa steg

• Läsa data från en databas (indatabindning)
• Spara data i en databas (utdatabindning)
• Kör en funktion när data ändras i en SQL-tabell (utlösare)
• Lär dig hur du ansluter Azure Function till Azure SQL med hanterad identitet