Dela via

Snabbstart: Använda Data API Builder med Azure SQL och Azure Static Web Apps

  • Artikel

I den här snabbstarten distribuerar du en AZD-mall (Azure Developer CLI). Mallen distribuerar en Azure Static-webbapp som är värd för data-API-byggaren med hjälp av den databasanslutningar funktion. Mallen innehåller också ett exempelprogram som du kan använda som utgångspunkt för dina lösningar.

Förutsättningar

Dricks

Du kan också öppna den här snabbstarten i GitHub Codespaces med alla krav för utvecklare redan installerade. Ta bara med din egen Azure-prenumeration. GitHub-konton innehåller en berättigande till lagring och kärntimmar utan kostnad. Mer information finns i inkluderade lagrings- och kärntimmar för GitHub-konton.

Öppna i GitHub Codespaces

Distribuera mallen

Distribuera först alla nödvändiga tjänster med hjälp av AZD-mallen.

  1. Öppna en terminal i projektets rotkatalog.

  2. Autentisera till Azure Developer CLI med hjälp av azd auth login. Följ stegen som anges av verktyget för att autentisera till CLI med dina önskade Azure-autentiseringsuppgifter.

    azd auth login

  3. Använd azd init för att initiera projektet.

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

    Viktig

    Om du kör i GitHub Codespaces kan du på ett säkert sätt utelämna argumentet --template eftersom koden redan har klonats till din miljö.

  4. Under initieringen konfigurerar du ett unikt miljönamn.

    Dricks

    Miljönamnet används också som målresursgruppnamn. I den här snabbstarten bör du överväga att använda msdocs-swa-dab.

  5. Distribuera Azure Static Web Apps-lösningen med hjälp av azd up. Bicep-mallarna distribuerar en Azure SQL-databas tillsammans med stödtjänster för lagring, identitet och värd. Ett exempelwebbprogram distribueras till webbvärden.

    azd up

  6. Under etableringsprocessen väljer du din prenumeration och önskad plats. Vänta tills etableringsprocessen har slutförts. Processen kan ta cirka fem minuter.

    Not

    Alla Azure-tjänster är inte tillgängliga i alla Azure-regioner. Mer information finns i Azure-produkter efter region.

  7. När etableringen av dina Azure-resurser är klar matar mallen ut ett SUCCESS- meddelande tillsammans med körningens varaktighet.

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

Konfigurera databasanslutningen

Använd nu databasanslutningar funktion i Azure Static Web Apps för att skapa en anslutning mellan den distribuerade statiska webbappen och den distribuerade databasen. Den här funktionen använder Data API Builder sömlöst för att skapa en anslutning till en Azure SQL-databas som körs med hjälp av de autentiseringsuppgifter som du anger.

  1. Gå till resursen Azure Static Web App i Azure-portalen.

  2. Konfigurera den statiska webbappen för att lägga till en -databasanslutning till Azure SQL-databasen med hjälp av de här inställningarna. Välj sedan Link.

    Värde
    Databastyp Azure SQL Database
    Prenumeration Välj den prenumeration som du använde för AZD-distributionen
    resursgrupp Välj den resursgrupp (miljö) som du använde för AZD-distributionen
    Resursnamn Välj den enda SQL Server-resursen med prefixet srvr-*
    Databasnamn adventureworkslt
    autentiseringstyp User-assigned managed identity
    Användartilldelad hanterad identitet *Välj den enda hanterade identitetsresursen med prefixet ua-id-*

    Skärmbild av databasanslutningssidan för en statisk webbapp i Azure-portalen.

  3. Välj nu alternativet Bläddra på resurssidan för att se hur webbprogrammet körs.

    Skärmbild av webbprogrammet som körs i Azure Static Web Apps.

Rensa

När du inte längre behöver exempelprogrammet eller resurserna tar du bort motsvarande distribution och alla resurser.

  1. Ta bort distributionen från din Azure-prenumeration.

    azd down

  2. Ta bort det kodområde som körs för att maximera dina lagrings- och kärnrättigheter om du använder GitHub Codespaces.

Nästa steg

REST-slutpunkter