Guia de início rápido: usar o construtor de API de dados com o SQL do Azure e os Aplicativos Web Estáticos do Azure

Artigo
01/28/2025

Neste início rápido, você implanta o Data API builder (DAB) como um contêiner do Docker para Aplicativos de Contêiner do Azure. Você usa um modelo de CLI do Desenvolvedor do Azure (AZD) para implantar o DAB junto com um banco de dados SQL do Azure usando as práticas recomendadas mais recentes. O modelo também implanta uma aplicação web de exemplo que se conecta ao ponto de extremidade DAB usando GraphQL.

Pré-requisitos

CLI do desenvolvedor do Azure
.NET 9.0

Se você não tiver uma conta do Azure, crie uma conta gratuita antes de começar.

Inicializar o projeto

Use a CLI do Desenvolvedor do Azure (azd) para criar uma conta SQL do Azure, implantar o DAB como uma solução em contêiner e implantar um aplicativo de exemplo em contêiner. A aplicação de exemplo usa DAB para consultar dados de exemplo.

Abra um terminal em um diretório vazio.
Se você ainda não estiver autenticado, autentique-se na CLI do Desenvolvedor do Azure usando azd auth login. Siga as etapas especificadas pela ferramenta para autenticar na CLI usando suas credenciais preferidas do Azure.
```
azd auth login
```

Use azd init para inicializar o projeto.

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

Durante a inicialização, configure um nome de ambiente exclusivo.
Implante a solução completa no Azure usando o azd up. Os modelos Bicep implantam uma conta SQL do Azure DAB para Aplicativos de Contêiner do Azure e um aplicativo Web de exemplo.
```
azd up
```
Durante o processo de provisionamento, selecione sua assinatura e o local desejado. Aguarde a conclusão do processo de provisionamento. O processo pode levar aproximadamente sete minutos.

Depois que o provisionamento dos recursos do Azure for concluído, uma URL para o aplicativo Web em execução será incluída na saída.

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.

Registre os valores para a URL do api e serviços de da Web. Você usa esses valores posteriormente neste guia.

Configurar a conexão do banco de dados

Agora, navegue até cada aplicativo em contêiner nos Aplicativos de Contêiner do Azure para validar se eles estão funcionando conforme o esperado.

Primeiro, navegue até à URL do serviço de API . Este URL vincula-se à instância do DAB em execução.
Observe a saída JSON do DAB. Ele deve indicar que o contêiner DAB está em execução e o status é íntegro.
```
{
  "status": "healthy",
  "version": "1.1.7",
  "app-name": "dab_oss_1.1.7"
}
```
Navegue até ao caminho relativo /swagger para a instância DAB. Essa URL deve abrir o Swagger UI do ambiente de desenvolvimento integrado (IDE) REST.
No Swagger IDE, execute uma solicitação de GET para todas as linhas na tabela do products SQL do Azure.
Por fim, navegue até à URL do serviço Web. Este URL liga à aplicação web de exemplo em execução que se conecta ao endpoint GraphQL acedido na etapa anterior.
Observe o aplicativo Web em execução e revise os dados de saída.

Limpeza

Quando você não precisar mais do aplicativo ou recursos de exemplo, remova a implantação correspondente e todos os recursos.

Remova a implantação da sua assinatura do Azure.
```
azd down
```
Exclua o espaço de código em execução para maximizar seus direitos de armazenamento e núcleo se estiver usando Codespaces do GitHub.

Próximo passo

pontos finais REST

Partilhar via