Démarrage rapide : Utiliser le générateur d’API de données avec Azure SQL et Azure Static Web Apps

Dans ce guide de démarrage rapide, vous déployez un modèle Azure Developer CLI (AZD). Le modèle déploie une application web statique Azure qui héberge le générateur d’API de données à l’aide de ses connexions de base de données fonctionnalité. Le modèle inclut également un exemple d’application que vous pouvez utiliser comme point de départ pour vos solutions.

Conditions préalables

• Abonnement Azure. Si vous n’avez pas d’abonnement Azure, créez un compte d’essai gratuit
• .NET 8
• azure Developer CLI

Pourboire

Vous pouvez également ouvrir ce guide de démarrage rapide dans GitHub Codespaces avec tous les prérequis pour les développeurs déjà installés. Apportez simplement votre propre abonnement Azure. Les comptes GitHub incluent un droit de stockage et des heures de base sans coût. Pour plus d’informations, consultez heures de stockage et de cœur incluses pour les comptes GitHub.

Déployer le modèle

Tout d’abord, déployez tous les services requis à l’aide du modèle AZD.

1. Ouvrez un terminal dans le répertoire racine du projet.

2. S’authentifier auprès d’Azure Developer CLI à l’aide de azd auth login. Suivez les étapes spécifiées par l’outil pour vous authentifier auprès de l’interface CLI à l’aide de vos informations d’identification Azure préférées.

   azd auth login
   

3. Utilisez azd init pour initialiser le projet.

   azd init --template dab-azure-sql-quickstart
   

   Important

   Si vous exécutez dans GitHub Codespaces, vous pouvez omettre en toute sécurité l’argument --template, car le code a déjà été cloné dans votre environnement.

4. Lors de l’initialisation, configurez un nom d’environnement unique.

   Pourboire

   Le nom de l’environnement sera également utilisé comme nom du groupe de ressources cible. Pour ce guide de démarrage rapide, envisagez d’utiliser msdocs-swa-dab.

5. Déployez la solution Azure Static Web Apps à l’aide de azd up. Les modèles Bicep déploient une base de données Azure SQL ainsi que les services de stockage, d’identité et d’hôte pris en charge. Un exemple d’application web est déployé sur l’hôte web.

   azd up
   

6. Pendant le processus d’approvisionnement, sélectionnez votre abonnement et l’emplacement souhaité. Attendez que le processus d’approvisionnement se termine. Le processus peut prendre environ cinq minutes.

   Note

   Tous les services Azure ne sont pas disponibles dans chaque région Azure. Pour plus d’informations, consultez produits Azure par région.

7. Une fois l’approvisionnement de vos ressources Azure terminée, le modèle génère un message SUCCESS ainsi que la durée de l’exécution.

   SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.
   

Configurer la connexion de base de données

À présent, utilisez les connexions de base de données fonctionnalité d’Azure Static Web Apps pour créer une connexion entre l’application web statique déployée et la base de données déployée. Cette fonctionnalité utilise le générateur d’API de données en toute transparence pour créer une connexion à une base de données Azure SQL en cours d’exécution à l’aide des informations d’identification que vous spécifiez.

1. Accédez à la ressource Azure Static Web App dans le portail Azure.

2. Configurez l’application web statique pour ajouter une connexion de base de données à la base de données Azure SQL à l’aide de ces paramètres. Sélectionnez ensuite lien.

   	Valeur
   type de base de données	Azure SQL Database
   abonnement	Sélectionnez l’abonnement que vous avez utilisé pour le déploiement AZD
   groupe de ressources	Sélectionnez le groupe de ressources (environnement) que vous avez utilisé pour le déploiement AZD
   nom de ressource	Sélectionner la seule ressource SQL Server avec un préfixe de srvr-*
   nom de base de données	adventureworkslt
   type d’authentification	User-assigned managed identity
   identité managée affectée par l’utilisateur	*Sélectionnez la seule ressource d’identité managée avec un préfixe de ua-id-*

   

3. À présent, sélectionnez l’option Parcourir sur la page de ressources pour observer l’exécution de l’application web.

   capture d’écran

Nettoyer

Lorsque vous n’avez plus besoin de l’exemple d’application ou de ressources, supprimez le déploiement correspondant et toutes les ressources.

1. Supprimez le déploiement de votre abonnement Azure.

   azd down
   

2. Supprimez l’espace de code en cours d’exécution pour optimiser vos droits de stockage et de base si vous utilisez GitHub Codespaces.

Étape suivante

points de terminaison REST