Konfiguration av databasanslutning i Azure Static Web Apps (förhandsversion)

Azure Static Web Apps-databasanslutningar fungerar med olika Azure-databaser.

När du ansluter en databas till din statiska webbapp måste du konfigurera databasens brandvägg för att acceptera nätverksåtkomst från Static Web Apps-arbetarna genom att tillåta nätverksåtkomst från Azure-resurser. Det går inte att tillåta specifika IP-adresser för Static Web Apps.

Om du använder autentiseringstypen Hanterad identitet måste du konfigurera den statiska webbappens profil för hanterad identitet för att få åtkomst till databasen.

Använd den här tabellen om du vill ha mer information om konfiguration av brandvägg och Managed Identity för databasen.

Konfiguration

Du definierar körningsbeteendet för databasanslutningen i filen staticwebapp.database.config.json. Innan du länkar en databas till din statiska webbapp måste du skapa den här filen i ditt repository. Enligt konventionen finns den här filen i mappen swa-db-connections i roten av ditt repo, men du kan flytta den om du vill.

Syftet med konfigurationsfilen är att:

• Mappa sökvägar från /data-api-endpointen till dina databastabeller eller entiteter
• Exponera REST- eller GraphQL-slutpunkter (eller båda)
• Definiera entitetssäkerhetsregler
• Styrning av konfigurationsinställningar för utveckling

Om du använder Azure Cosmos DB med GraphQL måste du också ange en gql schemafil.

Exempelkonfigurationsfil

Följande exempelkonfigurationsfil visar hur du ansluter till en Azure SQL-databas och exponerar både REST- och GraphQL-slutpunkter. Fullständig information om konfigurationsfilen och funktioner som filen stöder finns i Data API Builder-dokumentationen.

{
  "$schema": "https://github.com/Azure/data-api-builder/releases/latest/download/dab.draft.schema.json",
  "data-source": {
    "database-type": "mssql",
    "options": {
      "set-session-context": false 
    },
    "connection-string": "@env('DATABASE_CONNECTION_STRING')"
  },
  "runtime": {
    "rest": {
      "enabled": true,
      "path": "/rest"
    },
    "graphql": {
      "allow-introspection": true,
      "enabled": true,
      "path": "/graphql"
    },
    "host": {
      "mode": "production",
      "cors": {
        "origins": ["http://localhost:4280"],
        "allow-credentials": false
      },
      "authentication": {
        "provider": "StaticWebApps"
      }
    }
  },
  "entities": {
    "Person": {
      "source": "dbo.MyTestPersonTable",
      "permissions": [
        {
          "actions": ["create", "read", "update", "delete"],
          "role": "anonymous"
        }
      ]
    }
  }
}

Generera konfigurationsfil

Med Static Web Apps CLI kan du generera en konfigurationsfilmsmall.

Använd swa db init --database-type <YOUR_DATABASE_TYPE> för att generera en konfigurationsfil. Som standard skapar CLI en ny staticwebapp.database.config.json i en mapp med namnet swa-db-connections.

Databastyper som stöds är:

• mssql
• postgresql
• cosmosdb_nosql
• mysql

Anpassad konfigurationsmapp

Standardmappnamnet för filen staticwebapp.database.config.json är swa-db-connections. Om du vill använda en annan mapp måste du uppdatera arbetsflödesfilen för att tala om för körningen för Static Web Apps var konfigurationsfilen finns. Med data_api_location egenskapen kan du definiera platsen för konfigurationsmappen.

Följande kod visar hur du använder en mapp med namnet db-config som databaskonfigurationsfilens mapp.

app_location: "/src"
api_location: "api"
output_location: "/dist"
data_api_location: "db-config" # Folder holding the staticwebapp.database.config.json file

Konfigurera databasanslutning

Azure Static Web Apps måste ha nätverksåtkomst till databasen för att databasanslutningar ska fungera. Om du vill använda en Azure-databas för lokal utveckling måste du dessutom konfigurera databasen så att den tillåter begäranden från din egen IP-adress. Följande är allmänna steg som gäller för alla databaser. Specifika steg för din databastyp finns i länkarna ovan.

• Gå till databasen i Azure Portal.
• Gå till fliken Nätverk.
• Under avsnittet Brandväggsregler väljer du Lägg till din klient-IPv4-adress. Det här steget säkerställer att du kan använda den här databasen för din lokala utveckling.
• Markera kryssrutan Tillåt Azure-tjänster och resurser att komma åt den här servern . Det här steget säkerställer att din distribuerade Static Web Apps-resurs kan komma åt databasen.
• Välj Spara.

Anslut en databas

När du länkar en databas till din statiska webbapp upprättas produktionsanslutningen mellan din webbplats och databasen när den publiceras till Azure.

1. Öppna din statiska webbapp i Azure Portal.

2. I avsnittet Inställningar väljer du Databasanslutning.

3. I avsnittet Produktion väljer du länken Länka befintlig databas.

4. I fönstret Länka befintlig databas anger du följande värden:

   Fastighet	Värde
   Databastyp	Välj din databastyp i listrutan.
   Prenumeration	Välj din Azure-prenumeration i listrutan med nedrullningsbar lista.
   Resursnamn	Välj det databasservernamn som har önskad databas.
   Databasnamn	Välj namnet på den databas som du vill länka till din statiska webbapp.
   Autentiseringstyp	Välj den anslutningstyp som krävs för att ansluta till databasen.

Relaterat innehåll

Lägg till en databas i din statiska webbapp med någon av följande databaser:

• Azure Cosmos DB
• Azure SQL
• MySQL
• PostgreSQL

Dessutom kan du lära dig hur du använder Data API builder med Azure Static Web Apps.