Schnellstart: Verwenden des Daten-API-Generators mit Azure SQL und Azure Static Web Apps

Artikel
10/29/2024

In dieser Schnellstartanleitung stellen Sie eine Azure Developer CLI (AZD)-Vorlage bereit. Die Vorlage stellt eine Azure Static Web App bereit, die den Daten-API-Generator hostet, indem es Datenbankverbindungen Feature verwendet. Die Vorlage enthält auch eine Beispielanwendung, die Sie als Ausgangspunkt für Ihre Lösungen verwenden können.

Voraussetzungen

Azure-Abonnement. Wenn Sie nicht über ein Azure-Abonnement verfügen, erstellen Sie ein kostenloses Testkonto
.NET 8-
Azure Developer CLI-

Trinkgeld

Alternativ können Sie diese Schnellstartanleitung in GitHub Codespaces mit allen bereits installierten Entwicklervoraussetzungen öffnen. Bringen Sie einfach Ihr eigenes Azure-Abonnement mit. GitHub-Konten enthalten eine Berechtigung für Speicher und Kernstunden ohne Kosten. Weitere Informationen finden Sie unter enthaltene Speicher- und Kernstunden für GitHub-Konten.

Bereitstellen der Vorlage

Stellen Sie zunächst alle erforderlichen Dienste mithilfe der AZD-Vorlage bereit.

Öffnen Sie ein Terminal im Stammverzeichnis des Projekts.
Authentifizieren Sie sich mit azd auth loginbei der Azure Developer CLI. Führen Sie die vom Tool angegebenen Schritte aus, um sich mit Ihren bevorzugten Azure-Anmeldeinformationen bei der CLI zu authentifizieren.
```
azd auth login
```
Verwenden Sie azd init, um das Projekt zu initialisieren.
```
azd init --template dab-azure-sql-quickstart
```
Wichtig

Wenn Sie in GitHub Codespaces ausgeführt werden, können Sie das argument --template sicher weglassen, da der Code bereits in Ihre Umgebung geklont wurde.
Konfigurieren Sie während der Initialisierung einen eindeutigen Umgebungsnamen.

Trinkgeld

Der Umgebungsname wird auch als Zielressourcengruppenname verwendet. Ziehen Sie für diese Schnellstartanleitung die Verwendung von msdocs-swa-dabin Betracht.
Stellen Sie die Azure Static Web Apps-Lösung mit azd upbereit. Die Bicep-Vorlagen stellen eine Azure SQL-Datenbank zusammen mit den unterstützenden Speicher-, Identitäts- und Hostdiensten bereit. Eine Beispielwebanwendung wird auf dem Webhost bereitgestellt.
```
azd up
```
Wählen Sie während des Bereitstellungsprozesses Ihr Abonnement und den gewünschten Standort aus. Warten Sie, bis der Bereitstellungsprozess abgeschlossen ist. Der Vorgang kann ungefähr fünf Minutendauern.

Anmerkung

Nicht alle Azure-Dienste sind in jeder Azure-Region verfügbar. Weitere Informationen finden Sie unter Azure-Produkte nach Region.
Sobald die Bereitstellung Ihrer Azure-Ressourcen abgeschlossen ist, gibt die Vorlage eine SUCCESS Nachricht zusammen mit der Dauer der Ausführung aus.
```
SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.
```

Konfigurieren der Datenbankverbindung

Verwenden Sie nun die Datenbankverbindungen Feature von Azure Static Web Apps, um eine Verbindung zwischen der bereitgestellten statischen Web-App und der bereitgestellten Datenbank zu erstellen. Dieses Feature verwendet den Daten-API-Generator nahtlos, um eine Verbindung mit einer ausgeführten Azure SQL-Datenbank mithilfe der von Ihnen angegebenen Anmeldeinformationen zu erstellen.

Navigieren Sie zum Azure Static Web App Ressource im Azure-Portal.

Konfigurieren Sie die statische Web-App, um der Azure SQL-Datenbank mithilfe dieser Einstellungen eine Datenbankverbindung hinzuzufügen. Wählen Sie dann Linkaus.

	Wert
Datenbanktyp	`Azure SQL Database`
Abonnement-	Wählen Sie das Abonnement aus, das Sie für die AZD-Bereitstellung
Ressourcengruppe	Wählen Sie die Ressourcengruppe (Umgebung) aus, die Sie für die AZD-Bereitstellung
Ressourcenname	Wählen Sie die einzige SQL Server-Ressource mit dem Präfix `srvr-`*
Datenbankname	`adventureworkslt`
Authentifizierungstyp	`User-assigned managed identity`
vom Benutzer zugewiesenen verwalteten Identität	Wählen Sie die einzige verwaltete Identitätsressource mit dem Präfix `ua-id-`

Screenshot der Datenbankverbindungsseite für eine statische Web-App im Azure-Portal.

Wählen Sie nun die Option Durchsuchen auf der Ressourcenseite aus, um die ausgeführte Webanwendung zu beobachten.

Aufräumen

Wenn Sie die Beispielanwendung oder Ressourcen nicht mehr benötigen, entfernen Sie die entsprechende Bereitstellung und alle Ressourcen.

Entfernen Sie die Bereitstellung aus Ihrem Azure-Abonnement.
```
azd down
```
Löschen Sie den ausgeführten Codespace, um Ihre Speicher- und Kernberechtigungen zu maximieren, wenn Sie GitHub Codespaces verwenden.

Nächster Schritt

REST-Endpunkte

Freigeben über