Szybki start: używanie konstruktora interfejsu API danych z usługą Azure Cosmos DB for NoSQL i Azure Static Web Apps

Artykuł
01/28/2025

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) służy do wdrażania języka DAB wraz z bazą danych Azure Cosmos DB for NoSQL 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

Narzędzie CLI dla deweloperów platformy Azure
.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 Cosmos DB for NoSQL, 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.

Otwórz terminal w pustym katalogu.
Jeśli nie jesteś jeszcze uwierzytelniony, uwierzytelnij się w Azure Developer CLI używając 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
```

Użyj azd init, aby zainicjować projekt.

azd init --template dab-azure-cosmos-db-nosql-quickstart

Podczas inicjowania skonfiguruj unikatową nazwę środowiska.
Wdróż pełne rozwiązanie na platformie Azure przy użyciu azd up. Szablony Bicep wdrażają konto usługi Azure Cosmos DB for NoSQL DAB w usłudze Azure Container Apps i przykładową aplikację internetową.
```
azd up
```
Podczas procesu aprowizacji wybierz subskrypcję i żądaną lokalizację. Poczekaj na zakończenie procesu konfiguracji. Proces może potrwać około siedmiu minut.

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.

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.

Najpierw przejdź do adresu URL dla usługi interfejsu API . Ten adres URL prowadzi do aktywnego wystąpienia DAB.
Obserwuj dane wyjściowe JSON z DAB. Powinien on wskazywać, że kontener DAB jest uruchomiony, a jego status to zdrowy.
```
{
  "status": "healthy",
  "version": "1.1.7",
  "app-name": "dab_oss_1.1.7"
}
```
Przejdź do ścieżki względnej /graphql dla wystąpienia DAB. Ten adres URL powinien otworzyć Nitro zintegrowane środowisko programistyczne GraphQL (IDE).
W środowisku IDE nitro utwórz nowy dokument i uruchom to zapytanie, aby pobrać wszystkie 100 elementów w kontenerze usługi Azure Cosmos DB for NoSQL products.
```
query {
  products {
    items {
    id
    name
    description
    sku
    price
    cost
    }
  }
}
```
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.
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.

Usuń wdrożenie z subskrypcji platformy Azure.
```
azd down
```
Usuń aktywną przestrzeń kodową, aby zmaksymalizować dostęp do przestrzeni przechowywania oraz rdzeni, jeśli korzystasz z usługi GitHub Codespaces.

Następny krok

punkty końcowe GraphQL

Udostępnij za pośrednictwem