Freigeben über


Integrieren Sie die SQL-Datenbank in Microsoft Fabric mit Service Connector.

Diese Seite zeigt unterstützte Authentifizierungsmethoden und -clients und zeigt Beispielcode an, mit dem Sie Ihre Apps mit der SQL-Datenbank in Microsoft Fabric mithilfe von Service Connector verbinden können. Auf dieser Seite werden auch die Namen und Werte der Standardumgebungsvariablen angezeigt, die Sie erhalten, wenn Sie die Dienstverbindung erstellen.

Unterstützte Computedienste

Service Connector kann verwendet werden, um die folgenden Computedienste mit der SQL-Datenbank in Fabric zu verbinden:

  • Azure App Service
  • Azure Container Apps – ein Dienst für containerbasierte Anwendungen
  • Azure-Funktionen
  • Azure Kubernetes Service (AKS)

Unterstützte Authentifizierungstypen und Clienttypen

Die folgende Tabelle zeigt, welche Kombinationen von Authentifizierungsmethoden und Clients unterstützt werden, um ihren Computedienst mit sql-Datenbank in Fabric mithilfe von Service Connector zu verbinden. Ein "Ja" gibt an, dass die Kombination unterstützt wird, während ein "Nein" angibt, dass sie nicht unterstützt wird.

Clienttyp Vom System zugewiesene verwaltete Identität Vom Benutzer zugewiesene verwaltete Identität Geheimnis/Verbindungszeichenfolge Service Principal
.NETTO Ja Ja Nein Nein
Geh Ja Ja Nein Nein
Java Ja Ja Nein Nein
Java – Spring Boot Ja Ja Nein Nein
Python Ja Ja Nein Nein
Nichts Ja Ja Nein Nein

Diese Tabelle gibt an, dass gemäß Fabric-Verhalten nur die Authentifizierung über verwaltete Identitäten zulässig ist.

Die vom System zugewiesenen methoden für verwaltete Identität und vom Benutzer zugewiesene verwaltete Identität werden für .NET-, Java-, Java-, Spring Boot-, Python-, Go- und None-Clienttypen unterstützt. Diese Methoden werden für andere Typen nicht unterstützt.

Von Bedeutung

Momentan ist für ein vollständiges Onboarding eine manuelle Zugriffsfreigabe erforderlich. Sehen Sie Freigeben des Zugriffs auf die SQL-Datenbank in Fabric.

Namen von Standard-Umgebungsvariablen oder Anwendungseigenschaften und Beispielcode

Für Informationen zu Verbindungsdetails und Beispielcode, konsultieren Sie die folgenden Registerkarten, um Rechendienste mit der SQL-Datenbank in Fabric zu verbinden. Weitere Informationen zu Benennungskonventionen finden Sie im Artikel Besonderheiten des Dienstconnectors.

Hinweis

Obwohl sich die SQL-Datenbank in Fabric von der Azure SQL-Datenbank unterscheidet, können Sie eine Verbindung mit ihrer SQL-Datenbank in Fabric auf die gleiche Weise wie Azure SQL-Datenbank herstellen und abfragen. Erfahren Sie mehr.

Vom System zugewiesene verwaltete Identität

Standardname der Umgebungsvariablen BESCHREIBUNG Beispielwert
FABRIC_SQL_CONNECTIONSTRING Verbindungszeichenfolge für Azure SQL-Datenbank Data Source=tcp:<Fabric-SQL-Identifier>.msit-database.fabric.microsoft.com,1433;Initial Catalog=<SQL-DB-name>-<Fabric-DB-Identifier>;Authentication=ActiveDirectoryManagedIdentity

Beispielcode

Im Folgenden sind die Schritte und Codeausschnitte aufgeführt, um mithilfe einer vom System zugewiesenen verwalteten Identität eine Verbindung mit der SQL-Datenbank in Fabric herzustellen.

  1. Installieren Sie Abhängigkeiten.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Rufen Sie die Verbindungszeichenfolge der Instanz von SQL-Datenbank in Microsoft Fabric aus der Umgebungsvariable ab, die vom Dienstconnector hinzugefügt wurde.

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

    Weitere Informationen finden Sie unter Verwenden der verwalteten Active Directory-Identitätsauthentifizierung.

Weitere Informationen finden Sie unter Herstellen einer Verbindung mit Ihrer SQL-Datenbank in Microsoft Fabric.

Benutzerdefinierte verwaltete Identität

Standardname der Umgebungsvariablen BESCHREIBUNG Beispielwert
FABRIC_SQL_CONNECTIONSTRING Verbindungszeichenfolge für Azure SQL-Datenbank Data Source=tcp:<Fabric-SQL-Identifier>.msit-database.fabric.microsoft.com,1433;Initial Catalog=<SQL-DB-name>-<Fabric-DB-Identifier>;User ID=<msiClientId>;Authentication=ActiveDirectoryManagedIdentity

Beispielcode

Im Folgenden sind die Schritte und Codeausschnitte aufgeführt, um eine Verbindung mit der SQL-Datenbank in Fabric mithilfe einer vom Benutzer zugewiesenen verwalteten Identität herzustellen.

  1. Installieren Sie Abhängigkeiten.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Rufen Sie die Verbindungszeichenfolge der Instanz von SQL-Datenbank in Microsoft Fabric aus der Umgebungsvariable ab, die vom Dienstconnector hinzugefügt wurde.

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

    Weitere Informationen finden Sie unter Verwenden der verwalteten Active Directory-Identitätsauthentifizierung.

Weitere Informationen finden Sie unter Herstellen einer Verbindung mit Ihrer SQL-Datenbank in Microsoft Fabric.

Freigeben des Zugriffs auf sql-Datenbank in Fabric

  1. Schließen Sie die Erstellung Ihrer Dienstverbindung in der Cloud Shell oder auf Ihrer lokalen Azure CLI ab.

  2. Nachdem Ihre Verbindung erstellt wurde, öffnen Sie Ihre Computedienstressource im Azure-Portal, öffnen Sie das Menü "Service Connector" und suchen Sie Ihre SQL-Datenbank in der Fabric-Dienstverbindung. Wählen Sie die SQL-Datenbank aus, um zum Fabric-Portal zu navigieren.

    Screenshot des Azure-Portals, Auswählen des SQL-Datenbanklinks zum Fabric-Portal.

  3. Suchen Sie im Fabric-Portal die Registerkarte "Sicherheit ", und wählen Sie "SQL-Sicherheit verwalten" aus.

    Screenshot des Fabric-Portals, wählen Sie

  4. Wählen Sie die Rolle db_ddladmin aus, und verwalten Sie dann den Zugriff.

    Screenshot des Fabric-Portals, Auswählen der db_ddladmin Rolle und anschließendes Klicken auf

  5. Sie sollten den Namen Ihrer vom System zugewiesenen verwalteten Identität und/oder alle vom Benutzer zugewiesenen verwalteten Identitäten mit einer Dienstverbindung zu dieser SQL-Datenbank in Fabric sehen. Wählen Sie "Datenbank freigeben" aus. Wenn die Option " Datenbank freigeben " nicht angezeigt wird, müssen Sie nicht mit den verbleibenden Schritten fortfahren.

    Screenshot des Fabric-Portals, Anzeigen einer Liste von Gruppen, die der Rolle hinzugefügt wurden, und Klicken auf

  6. Geben Sie den Namen Ihrer neu erstellten vom System zugewiesenen verwalteten Identität und/oder alle vom Benutzer zugewiesenen verwalteten Identitäten ein, und wählen Sie ihn aus, wie sie im Bereich "Zugriff verwalten " angezeigt werden. Fügen Sie alle anderen Identitäten nach Bedarf hinzu. Aktivieren Sie das Kontrollkästchen Alle Daten mit SQL-Datenbank lesen, und wählen Sie dann Zuweisen aus.

    Screenshot des Fabric-Portals, Geben Sie die Namen aller zugewiesenen verwalteten Identitäten ein, wählen Sie

  7. Sie können jetzt Ihre neue Dienstverbindung mit der SQL-Datenbank in Fabric verwenden.

Nächster Schritt

Weitere Informationen zu Service Connector finden Sie im folgenden Artikel.