Szybki start: używanie konstruktora interfejsu API danych z usługami Azure SQL i Azure Static Web Apps

W tym przewodniku szybkiego startu wdrożysz builder interfejsu API dla danych (DAB) jako kontener Docker w usłudze Azure Container Apps. Szablon interfejsu wiersza polecenia dla deweloperów platformy Azure (AZD) jest używany do wdrażania języka DAB wraz z bazą danych Azure SQL Database przy użyciu najnowszych najlepszych rozwiązań. Szablon wdraża również przykładową aplikację internetową, która łączy się z punktem końcowym języka DAB przy użyciu języka GraphQL.

Warunki wstępne

• Azure Developer CLI
• .NET 9.0

Jeśli nie masz konta platformy Azure, przed rozpoczęciem utwórz bezpłatne konto .

Inicjowanie projektu

Użyj interfejsu wiersza polecenia dla deweloperów platformy Azure (azd), aby utworzyć konto usługi Azure SQL, wdrożyć daB jako rozwiązanie konteneryzowane i wdrożyć konteneryzowaną przykładową aplikację. Przykładowa aplikacja używa języka DAB do wykonywania zapytań dotyczących przykładowych danych.

1. Otwórz terminal w pustym katalogu.

2. Jeśli jeszcze nie uwierzytelniono się, uwierzytelnij się w interfejsie wiersza polecenia dewelopera platformy Azure przy użyciu azd auth login. Wykonaj kroki określone przez narzędzie, aby uwierzytelnić się w interfejsie wiersza polecenia przy użyciu preferowanych poświadczeń platformy Azure.

   azd auth login
   

3. Użyj azd init, aby zainicjować projekt.

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

4. Podczas inicjowania skonfiguruj unikatową nazwę środowiska.

5. Wdróż pełne rozwiązanie na platformie Azure przy użyciu azd up. Szablony Bicep wdrażają konto usługi Azure SQL DAB w usłudze Azure Container Apps i przykładową aplikację internetową.

   azd up
   

6. Podczas procesu aprowizacji wybierz subskrypcję i żądaną lokalizację. Poczekaj na zakończenie procesu aprowizacji. Proces może potrwać około siedmiu minut.

7. Po zakończeniu aprowizacji zasobów platformy Azure adres URL uruchomionej aplikacji internetowej zostanie uwzględniony w danych wyjściowych.

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service api
   - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>
   
   (✓) Done: Deploying service web
   - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>
   
   SUCCESS: Your up workflow to provision and deploy to Azure completed in 7 minutes 0 seconds.
   

8. Rejestruj wartości adresu URL interfejsu API i usług sieci Web. Te wartości są używane w dalszej części tego przewodnika.

Konfigurowanie połączenia z bazą danych

Teraz przejdź do każdej konteneryzowanej aplikacji w usłudze Azure Container Apps, aby sprawdzić, czy działają zgodnie z oczekiwaniami.

1. Najpierw przejdź do adresu URL dla usługi interfejsu API . Ten adres URL łączy się z uruchomionym wystąpieniem daB.

2. Obserwuj dane wyjściowe JSON z DAB. Powinien on wskazywać, że kontener DAB jest uruchomiony, a stan to w dobrej kondycji.

   {
     "status": "healthy",
     "version": "1.1.7",
     "app-name": "dab_oss_1.1.7"
   }
   

3. Przejdź do względnej ścieżki /swagger dla instancji DAB. Ten adres URL powinien otworzyć interfejs użytkownika swagger zintegrowanego środowiska projektowego REST (IDE).

4. W środowisku IDE programu Swagger uruchom żądanie GET dla wszystkich wierszy w tabeli usługi Azure SQL products.

5. Na koniec przejdź do adresu URL usługi sieci Web . Ten adres URL łączy się z uruchomioną przykładową aplikacją internetową, która łączy się z punktem końcowym GraphQL, do którego uzyskiwano dostęp w poprzednim kroku.

6. Obserwuj uruchomioną aplikację internetową i przejrzyj dane wyjściowe.

   

Czyszczenie

Jeśli nie potrzebujesz już przykładowej aplikacji lub zasobów, usuń odpowiednie wdrożenie i wszystkie zasoby.

1. Usuń wdrożenie z subskrypcji platformy Azure.

   azd down
   

2. Usuń działającą przestrzeń kodu, aby zmaksymalizować uprawnienia magazynu i rdzenia, jeśli używasz usługi GitHub Codespaces.

Następny krok

punktów końcowych REST