Herstellen einer Verbindung mit einer Datenbank mit Azure Static Web Apps (Vorschau)

Mit dem Azure Static Web Apps-Datenbankverbindungsfeature können Sie von Ihrer statischen Web-App aus auf eine Datenbank zugreifen, ohne benutzerdefinierten serverseitigen Code zu schreiben.

Nachdem Sie eine Verbindung zwischen Ihrer Webanwendung und Der Datenbank erstellt haben, können Sie Daten mit vollständiger Unterstützung für CRUD-Vorgänge, integrierte Autorisierung und Beziehungen bearbeiten.

Basierend auf dem Daten-API-Generator übernimmt Azure Static Web Apps REST- und GraphQL-Anforderungen und konvertiert sie in Datenbankabfragen.

Zu den features, die von Datenbankverbindungen unterstützt werden, gehören:

Unterstützte Datenbanken

Die folgende Tabelle zeigt unterstützung für verschiedene relationale und NoSQL-Datenbanken.

Sie können die folgenden Verbindungstypen für den Datenbankzugriff verwenden:

• Verbindungszeichenfolge
• Dem Benutzer zugewiesene Managed Identity
• Vom System zugewiesene verwaltete Identität

Endpoint location

Der Zugriff auf Datenendpunkte ist außerhalb des /data-api Pfads verfügbar.

In der folgenden Tabelle wird gezeigt, wie Anforderungen an verschiedene Teile einer statischen Web-App weitergeleitet werden:

Wenn Sie Datenbankverbindungen auf Ihrer Website konfigurieren, können Sie das REST- oder GraphQL-Suffix der /data-api/* Route konfigurieren. Das /data-api Präfix ist eine Konvention statischer Web Apps und kann nicht geändert werden.

Konfiguration

Es gibt zwei Schritte zum Konfigurieren einer Datenbankverbindung in Static Web Apps. Sie müssen Ihre Datenbank mit Ihrer statischen Web-App im Azure-Portal verbinden und die Konfigurationsdatei für Datenbankverbindungen aktualisieren.

Weitere Details finden Sie unter Datenbankverbindungskonfiguration in Azure Static Web Apps .

Lokale Entwicklung

Die Azure Static Web Apps CLI (SWA CLI) umfasst Unterstützung für das Arbeiten mit Datenbankverbindungen während der lokalen Entwicklung.

Die CLI aktiviert den lokalen /data-api Endpunkt und leitet Anfragen vom Port 4280 an den entsprechenden Port für den Datenbankzugriff weiter.

Hier ist ein Beispielbefehl, der die SWA CLI mit einer Datenbankverbindung startet:

swa start ./src --data-api-location swa-db-connections

Dieser Befehl startet die SWA CLI im src-Verzeichnis . Die --data-api-location Option weist die CLI an, dass ein Ordner mit dem Namen "swa-db-connections " die staticwebapp.database.config.json Datei enthält.

Rollenbasierte Sicherheit

Wenn Sie eine Entität in der Datei staticwebapp.database.config.json definieren, können Sie eine Liste der Rollen angeben, die erforderlich sind, um auf einen Endpunkt der Entität zuzugreifen.

Das folgende Konfigurationsfragment erfordert die Administratorrolle, um auf alle Aktionen (create, read, , updatedelete) für die Orders-Entität zuzugreifen.

{
...
"entities": { 
  "Orders": { 
    "source": "dbo.Orders", 
    "permissions": [ 
      { 
        "actions": ["*"], 
        "role": "admin" 
      }
    ]
 }
}
...
}

Wenn Sie Aufrufe an einen Endpunkt tätigen, der eine Rolle erfordert, sind die folgenden Bedingungen erforderlich:

1. Der aktuelle Benutzer muss authentifiziert werden.

2. Der aktuelle Benutzer muss Mitglied der erforderlichen Rolle sein.

3. Die REST- oder GraphQL-Anforderung muss einen Header mit dem Schlüssel X-MS-API-ROLE und einem Wert des Rollennamens enthalten, der den in den Entitätskonfigurationsregeln aufgeführten Wert entspricht.

   Der folgende Codeausschnitt zeigt beispielsweise, wie die Administratorrolle in einem Anforderungsheader übergeben wird.

   {
     method: "POST",
     headers: { 
       "Content-Type": "application/json",
       "X-MS-API-ROLE": "admin"
     },
     body: JSON.stringify(requestPayload)
   }
   

Constraints

• Auf Datenbanken muss über die Infrastruktur von Azure zugegriffen werden kann.
• Während der öffentlichen Vorschau skalieren Datenbankverbindungen von 0 bis 1 Datenbankmitarbeiter.

Nächste Schritte