Lernprogramm: Verbinden von App Service mit einer SQL-Datenbank in Fabric mithilfe von Service Connector

In diesem Leitfaden erfahren Sie, wie Sie eine Azure App Service-Ressource mit einer SQL-Datenbank in Microsoft Fabric mithilfe von Service Connector verbinden. Mit diesem Setup kann Ihre Web-App nahtlos mit der SQL-Datenbank in Microsoft Fabric interagieren.

Erstellen einer Dienstverbindung zwischen Azure App Service und einer SQL-Datenbank in Fabric
Gewähren von Datenbankzugriffsberechtigungen für Ihre Web-App

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie folgendes haben:

Ein Azure-Konto mit einem aktiven Abonnement. Kostenlos ein Konto erstellen.
Eine in App Service gehostete App. Wenn Sie nicht über eine App verfügen, erstellen und bereitstellen Sie eine App im App Service.
Eine SQL-Datenbank in Microsoft Fabric. Wenn Sie nicht über eine Datenbank verfügen, erstellen Sie eine SQL-Datenbank in Fabric.

Erstellen einer Dienstverbindung

Erstellen Sie mithilfe der Azure CLI oder des Azure-Portals eine neue Dienstverbindung von App Service zu einer SQL-Datenbank in Fabric.

Azure CLI
Azure-Portal

Installieren Sie die kennwortlose Service Connector-Erweiterung für die Azure CLI.
```
az extension add --name serviceconnector-passwordless --upgrade
```
Sammeln Sie die erforderlichen Informationen:
- Abonnement-ID: Auf der Registerkarte " Übersicht" des App-Diensts gefunden
- Ressourcengruppenname: Auf der Registerkarte "Übersicht" des App-Dienstes gefunden
- Fabric-Arbeitsbereichs-UUID (universell eindeutige Kennung) und SQL-Datenbank-UUID: Gefunden durch Navigieren zu Ihrer SQL-Datenbank im Fabric-Portal. Die Browser-URL sollte wie folgt aussehen: https://msit.powerbi.com/groups/<fabric_workspace_uuid>/sqldatabases/<fabric_sql_db_uuid>. Die erste UUID in der URL ist der Fabric-Arbeitsbereich UUID, und die zweite UUID ist die SQL-Datenbank UUID.
- App-ID (nur für die vom Benutzer zugewiesene verwaltete Identitätsauthentifizierung): Im Microsoft Entra Admin Center unter Entra ID > Enterprise-Apps gefunden. Suchen Sie nach Ihrer Anwendung und finden Sie die Anwendungs-ID.

Erstellen Sie die Dienstverbindung mithilfe einer vom System zugewiesenen verwalteten Identität oder einer vom Benutzer zugewiesenen verwalteten Identität. In beiden Fällen ermöglicht der Service Connector eine verwaltete Identität für die Authentifizierung und fügt eine Verbindungszeichenfolge mit dem Namen FABRIC_SQL_CONNECTIONSTRING zu den App Settings hinzu.

Vom System zugewiesene verwaltete Identität:

az webapp connection create fabric-sql \
    --source-id /subscriptions/<subscription-ID>/resourceGroups/<source-resource-group>/providers/Microsoft.Web/sites/<site> \
    --target-id https://api.fabric.microsoft.com/v1/workspaces/<fabric_workspace_uuid>/SqlDatabases/<fabric_sql_db_uuid> \
    --system-identity

Vom Benutzer zugewiesene verwaltete Identität:

az webapp connection create fabric-sql \
    --source-id /subscriptions/<subscription-ID>/resourceGroups/<source-resource-group>/providers/Microsoft.Web/sites/<site> \
    --target-id https://api.fabric.microsoft.com/v1/workspaces/<fabric_workspace_uuid>/SqlDatabases/<fabric_sql_db_uuid> \
    --user-identity client-id=<app-ID> "subs-id=<subscription-ID>"

Weitere Informationen zu diesen Befehlen und weiteren Optionen finden Sie unter az webapp connection create.

Öffnen Sie im Azure-Portal Ihre App Service-Ressource.
Wählen Sie im Servicemenü "Einstellungen>Dienstconnector" aus.

Wählen Sie "Erstellen" aus, und konfigurieren Sie die folgenden Einstellungen im daraufhin geöffneten Bereich "Verbindung erstellen ".

Konfiguration	Beispiel	BESCHREIBUNG
Diensttyp	SQL-Datenbank in Fabric	Der Zieldiensttyp: SQL-Datenbank in Fabric.
Verbindungsname	fabricsql_8293d	Ein Verbindungsname, der die Verbindung zwischen Ihrem App Service und der SQL-Datenbank identifiziert. Bearbeiten Sie optional den Verbindungsnamen, wie von Service Connector standardmäßig vorgeschlagen.
Arbeitsbereich	Mein Arbeitsbereich	Der Microsoft Fabric-Arbeitsbereich, der Ihre SQL-Datenbank enthält.
SQL-Datenbank	my_sql_database	Die SQL-Zieldatenbank, mit der Sie eine Verbindung herstellen möchten.
Clienttyp	.NETTO	Der Technologie-Stack oder die Bibliothek der Anwendung.

Wählen Sie "Weiter" aus: Authentifizierung und wählen Sie Ihre bevorzugte Option für die verwaltete Identitätsauthentifizierung (vom System zugewiesen oder vom Benutzer zugewiesen). In beiden Fällen ermöglicht Service Connector eine verwaltete Identität für die Authentifizierung und fügt eine Verbindungszeichenfolge zu Den App-Einstellungen namens FABRIC_SQL_CONNECTIONSTRINGhinzu.
Wählen Sie "Weiter" aus: Netzwerküberprüfung>+ Erstellen , um Ihre Verbindungskonfiguration zu überprüfen.
Aktivieren Sie das Kontrollkästchen, mit dem Sie bestätigen, dass Sie verstehen, dass zusätzliche manuelle Schritte erforderlich sind, um diese Service-Verbindung zu konfigurieren, und wählen Sie Create On Cloud Shell aus. Der Befehl wird automatisch in der Azure Cloud Shell ausgeführt. Wenn Sie die Azure CLI installiert haben, kopieren Sie die bereitgestellten CLI-Befehle auf Ihrem lokalen Computer, und führen Sie sie aus.
Sobald der Befehl abgeschlossen ist, schließen Sie den Bereich "Erstellen der Verbindung".

Konfigurieren von Datenbankzugriffsberechtigungen

Nach dem Erstellen der Dienstverbindung müssen Sie Ihrer verwalteten Identität die erforderlichen Berechtigungen für den Zugriff auf die SQL-Datenbank erteilen.

Wechseln Sie im Azure-Portal zum Service Connector-Menü Ihres App Service, und wählen Sie "Aktualisieren" aus, um Ihre neue Verbindung anzuzeigen.
Wählen Sie unter "Ressourcenname" den SQL-Datenbanklink aus, um Ihre Datenbank im Microsoft Fabric-Portal zu öffnen.
Navigieren Sie im Fabric-Portal zur Registerkarte " Sicherheit ", und wählen Sie "SQL-Sicherheit verwalten" aus.
Navigieren Sie zur Berechtigungsverwaltungsschnittstelle, indem Sie die db_datareader Rolle auswählen, und wählen Sie dann "Zugriff verwalten" aus. Sie gewähren dieser Rolle ihrer verwalteten Identität nicht; So greifen Sie nur auf die Fabric-Berechtigungseinstellungen zu.
Suchen Sie unter "Personen", "Gruppen" oder "Apps" in dieser Rolle nach Ihrem verwalteten Identitätsnamen. Wenn eine Option " Datenbank freigeben " angezeigt wird, fahren Sie mit dem nächsten Schritt fort. Andernfalls sind die Berechtigungen bereits konfiguriert.
Geben Sie den Namen Ihrer verwalteten Identität ein, und wählen Sie ihn aus, wie sie im Bereich " Zugriff verwalten " angezeigt wird, aktivieren Sie "Alle Daten mit SQL-Datenbank lesen", und wählen Sie "Erteilen" aus.

Bereinigen von Ressourcen

Löschen Sie die Ressourcengruppe und alle zugehörigen, für dieses Tutorial erstellten Ressourcen, wenn Sie sie nicht mehr benötigen. Wählen Sie dazu die Ressourcengruppe oder die einzelnen Ressourcen aus, die Sie erstellt haben, und wählen Sie "Löschen" aus.

Feedback

War diese Seite hilfreich?

Last updated on 2025-06-28