Nawiązywanie połączenia z bazą danych za pomocą usługi Azure Static Web Apps (wersja zapoznawcza)

Funkcja połączenia bazy danych usługi Azure Static Web Apps umożliwia dostęp do bazy danych ze statycznej aplikacji internetowej bez konieczności pisania niestandardowego kodu po stronie serwera.

Po utworzeniu połączenia między aplikacją internetową a bazą danych można manipulować danymi przy użyciu pełnej obsługi operacji CRUD, wbudowanej autoryzacji i relacji.

Na podstawie konstruktora interfejsu API danych usługa Azure Static Web Apps pobiera żądania REST i GraphQL i konwertuje je na zapytania bazy danych.

Funkcje obsługiwane przez połączenia z bazą danych obejmują:

Obsługiwane bazy danych

W poniższej tabeli przedstawiono obsługę różnych relacyjnych i noSQL baz danych.

Do uzyskiwania dostępu do bazy danych można użyć następujących typów połączeń:

• Łańcuch połączenia
• Tożsamość zarządzana przypisana przez użytkownika
• Tożsamość zarządzana przypisana przez system

Lokalizacja punktu końcowego

Dostęp do punktów końcowych danych jest dostępny poza ścieżką /data-api .

W poniższej tabeli przedstawiono sposób kierowania żądań do różnych części statycznej aplikacji internetowej:

Podczas konfigurowania połączeń baz danych w witrynie internetowej można skonfigurować sufiks ścieżki /data-api/* REST lub GraphQL. Prefiks /data-api jest konwencją usługi Static Web Apps i nie można jej zmienić.

Konfiguracja

Istnieją dwa kroki konfigurowania połączenia bazy danych w usłudze Static Web Apps. Musisz połączyć bazę danych ze statyczną aplikacją internetową w witrynie Azure Portal i zaktualizować plik konfiguracji połączeń bazy danych.

Aby uzyskać więcej szczegółów, zobacz Konfiguracja połączenia z bazą danych w usłudze Azure Static Web Apps .

Rozwój lokalny

Interfejs wiersza polecenia usługi Azure Static Web Apps (SWA CLI) obejmuje obsługę pracy z połączeniami bazy danych podczas programowania lokalnego.

Interfejs wiersza polecenia aktywuje lokalny /data-api punkt końcowy i przekierowuje żądania z portu 4280 do odpowiedniego portu w celu uzyskania dostępu do bazy danych.

Oto przykładowe polecenie, które uruchamia SWA CLI z połączeniem bazy danych.

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

To polecenie uruchamia SWA CLI w katalogu src. Opcja --data-api-location informuje interfejs wiersza polecenia, że folder o nazwie swa-db-connections przechowuje plik staticwebapp.database.config.json .

Zabezpieczenia oparte na rolach

Podczas definiowania jednostki w pliku staticwebapp.database.config.json można określić listę ról wymaganych do uzyskania dostępu do punktu końcowego jednostki.

Poniższy fragment konfiguracji wymaga roli administratora , aby uzyskać dostęp do wszystkich akcji (create, read, update, delete) w jednostce zamówienia .

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

Gdy wykonujesz wywołania do endpointu wymagającego roli, wymagane są następujące warunki:

1. Bieżący użytkownik musi być uwierzytelniony.

2. Bieżący użytkownik musi być członkiem wymaganej roli.

3. Żądanie REST lub GraphQL musi zawierać nagłówek z kluczem X-MS-API-ROLE i wartością nazwy roli pasującej do elementów wymienionych w regułach konfiguracji jednostki.

   Na przykład poniższy fragment kodu pokazuje, jak przekazać rolę administratora w nagłówku żądania.

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

Constraints

• Bazy danych muszą być dostępne dla infrastruktury platformy Azure.
• W publicznej wersji zapoznawczej połączenia bazy danych są skalowane z zakresu od 0 do 1 procesu roboczego bazy danych.

Dalsze kroki