Freigeben über


Integrieren von Azure SQL-Datenbank mit dem Dienstconnector

Auf dieser Seite werden unterstützte Authentifizierungsmethoden und Clients sowie Beispielcode gezeigt, den Sie verwenden können, um Computedienste mit Azure SQL-Datenbank mithilfe des Dienstconnectors zu verbinden. Möglicherweise können Sie mit anderen Methoden eine Verbindung mit der Azure SQL-Datenbank herstellen. Auf dieser Seite werden auch die Namen und Werte der Standardumgebungsvariablen angezeigt, die Sie erhalten, wenn Sie die Dienstverbindung erstellen.

Unterstützte Computedienste

Der Dienstconnector kann verwendet werden, um die folgenden Computedienste mit Azure SQL-Datenbank zu verbinden:

  • Azure App Service
  • Azure Container Apps
  • Azure-Funktionen
  • Azure Kubernetes Service (AKS)
  • Azure Spring Apps

Unterstützte Authentifizierungstypen und Clients

Die folgende Tabelle zeigt, welche Kombinationen von Authentifizierungsmethoden und Clients für die Verbindung Ihres Computediensts mit Azure SQL-Datenbank mithilfe des Dienstconnectors unterstützt werden. Ein „Ja“ gibt an, dass die Kombination unterstützt wird, während ein „Nein“ angibt, dass sie nicht unterstützt wird.

Clienttyp Systemseitig zugewiesene verwaltete Identität Benutzerseitig zugewiesene verwaltete Identität Geheimnis/Verbindungszeichenfolge Dienstprinzipal
.NET Ja Ja Ja Ja
Go No Nein Ja No
Java Ja Ja Ja Ja
Java - Spring Boot Ja Ja Ja Ja
Node.js Ja Ja Ja Ja
PHP No Nein Ja Nein
Python Ja Ja Ja Ja
Python – Django No Nein Ja No
Ruby No Nein Ja Nein
Keine Ja Ja Ja Ja

Diese Tabelle gibt an, dass das Geheimnis/die Verbindungszeichenfolgenmethode für alle Clienttypen unterstützt wird. Die vom System zugewiesenen verwalteten Identitäten, die vom Benutzer zugewiesenen verwalteten Identitäten und die Dienstprinzipalmethoden werden für die Client-Typen .NET, Java, Java – Spring Boot, Node.js, Python und None unterstützt. Diese Methoden werden für Go-, PHP-, Django- und Ruby-Clienttypen nicht unterstützt.

Hinweis

Vom System zugewiesene verwaltete Identität, vom Benutzer zugewiesene verwaltete Identität und Dienstprinzipal werden nur in Azure CLI unterstützt.

Namen von Standard-Umgebungsvariablen oder Anwendungseigenschaften und Beispielcode

Verwenden Sie die nachstehenden Verbindungsdetails, um Computedienste mit Azure SQL-Datenbank zu verbinden. Ersetzen Sie in jedem unten genannten Beispiel die Platzhaltertexte <sql-server>, <sql-database>, <sql-username> und <sql-password> durch Ihre Werte für eigenen Servername, Datenbankname, Benutzer-ID und Kennwort. Weitere Informationen zu Benennungskonventionen finden Sie im Artikel Besonderheiten des Dienstconnectors.

Systemseitig zugewiesene verwaltete Identität

Standardname der Umgebungsvariablen Beschreibung Beispielwert
AZURE_SQL_CONNECTIONSTRING Verbindungszeichenfolge für Azure SQL-Datenbank Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;Authentication=ActiveDirectoryManagedIdentity

Beispielcode

Lesen Sie die Schritte und den folgenden Code, um eine Verbindung mit der Azure SQL-Datenbank mithilfe einer vom System zugewiesenen verwalteten Identität herzustellen.

  1. Installieren Sie Abhängigkeiten.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Rufen Sie die Azure SQL-Datenbank-Verbindungszeichenfolge aus der Umgebungsvariable ab, die vom Dienstconnector hinzugefügt wird.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

    Weitere Informationen finden Sie unter Verwenden der Active Directory mit verwalteter Identität-Authentifizierung.

Weitere Informationen finden Sie unter Startseite für die Clientprogrammierung in Microsoft SQL Server.

Benutzerseitig zugewiesene verwaltete Identität

Standardname der Umgebungsvariablen Beschreibung Beispielwert
AZURE_SQL_CONNECTIONSTRING Verbindungszeichenfolge für Azure SQL-Datenbank Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;User ID=<identity-client-ID>;Authentication=ActiveDirectoryManagedIdentity

Beispielcode

Lesen Sie die Schritte und den folgenden Code, um eine Verbindung mit der Azure SQL-Datenbank mithilfe einer vom Benutzer zugewiesenen verwalteten Identität herzustellen.

  1. Installieren Sie Abhängigkeiten.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Rufen Sie die Azure SQL-Datenbank-Verbindungszeichenfolge aus der Umgebungsvariable ab, die vom Dienstconnector hinzugefügt wird.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

    Weitere Informationen finden Sie unter Verwenden der Active Directory mit verwalteter Identität-Authentifizierung.

Weitere Informationen finden Sie unter Startseite für die Clientprogrammierung in Microsoft SQL Server.

Verbindungszeichenfolge

Warnung

Microsoft empfiehlt, immer den sichersten Authentifizierungsflow zu verwenden. Der in diesem Verfahren beschriebene Authentifizierungsflow erfordert ein sehr hohes Maß an Vertrauen in die Anwendung und birgt Risiken, die bei anderen Flows nicht vorhanden sind. Sie sollten diesen Flow nur verwenden, wenn andere sicherere Flows (z. B. verwaltete Identitäten) nicht anwendbar sind.

Standardname der Umgebungsvariablen Beschreibung Beispielwert
AZURE_SQL_CONNECTIONSTRING Verbindungszeichenfolge für Azure SQL-Datenbank Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;Password=<sql-password>

Beispielcode

Lesen Sie die Schritte und den folgenden Code, um eine Verbindung mit der Azure SQL-Datenbank mithilfe einer Verbindungszeichenfolge.

  1. Installieren Sie Abhängigkeiten.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Rufen Sie die Azure SQL-Datenbank-Verbindungszeichenfolge aus der Umgebungsvariable ab, die vom Dienstconnector hinzugefügt wird.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

Weitere Informationen finden Sie unter Startseite für die Clientprogrammierung in Microsoft SQL Server.

Dienstprinzipal

Standardname der Umgebungsvariablen Beschreibung Beispielswert
AZURE_SQL_CLIENTID Ihre Client-ID <client-ID>
AZURE_SQL_CLIENTSECRET Ihr geheimer Clientschlüssel <client-secret>
AZURE_SQL_TENANTID Ihre Mandanten-ID <tenant-ID>
AZURE_SQL_CONNECTIONSTRING Verbindungszeichenfolge für Azure SQL-Datenbank Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;User ID=<client-Id>;Password=<client-secret>;Authentication=ActiveDirectoryServicePrincipal

Beispielcode

Lesen Sie die Schritte und den folgenden Code, um eine Verbindung mit der Azure SQL-Datenbank mithilfe eines Dienstprinzipals.

  1. Installieren Sie Abhängigkeiten.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Rufen Sie die Azure SQL-Datenbank-Verbindungszeichenfolge aus der Umgebungsvariable ab, die vom Dienstconnector hinzugefügt wird.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

    Weitere Informationen finden Sie unter Verwenden der Active Directory mit verwalteter Identität-Authentifizierung.

Weitere Informationen finden Sie unter Startseite für die Clientprogrammierung in Microsoft SQL Server.

Nächste Schritte

Arbeiten Sie das unten aufgeführte Tutorial durch, um mehr über den Dienstconnector zu erfahren.