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

W tym przewodniku szybkiego startu stworzysz Data API builder 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.

Wymagania wstępne

• Azure Developer CLI
• .NET 9.0

Jeśli nie masz jeszcze 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 jesteś uwierzytelniony, uwierzytelnij się za pomocą Azure Developer CLI przy użyciu polecenia 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 do zainicjowania projektu.

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

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

5. Przed przejściem do następnego kroku upewnij się, że platforma Docker jest uruchomiona na maszynie.

6. 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
   

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

8. 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.
   

9. Zarejestruj wartości adresu URL interfejsu API oraz usług internetowych . 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 prowadzi do aktywnego wystąpienia DAB.

2. Obserwuj dane wyjściowe JSON z DAB. Powinien on wskazywać, że kontener DAB jest uruchomiony, a jego status to zdrowy.

   {
     "status": "healthy",
     "version": "1.4.35",
     "app-name": "dab_oss_1.4.35"
   }
   

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 . 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ń aktywną przestrzeń kodową, aby zmaksymalizować dostęp do przestrzeni przechowywania oraz rdzeni, jeśli korzystasz z usługi GitHub Codespaces.

Następny krok

punktów końcowych REST