Guia de início rápido: usar o construtor de API de dados com o SQL do Azure e os Aplicativos de Contêiner do Azure

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 um exemplo de aplicação web que se conecta ao ponto de extremidade DAB usando GraphQL.

Pré-requisitos

• Azure Developer CLI
• .NET 9.0

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

1. Abra um terminal em um diretório vazio.

2. Caso ainda não esteja autenticado, autentique-se no Azure Developer CLI usando azd auth login. Siga as etapas especificadas pela ferramenta para autenticar na CLI usando suas credenciais preferidas do Azure.

   azd auth login
   

3. Use azd init para inicializar o projeto.

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

4. Durante a inicialização, configure um nome de ambiente exclusivo.

5. Verifique se o Docker está em execução em sua máquina antes de continuar para a próxima etapa.

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

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

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

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

Configurar a ligação à base 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.

1. Primeiro, navegue até a URL do serviço de API . Este URL vincula-se à instância do DAB em execução.

2. Observe a saída em JSON do DAB. Ele deve indicar que o contêiner DAB está em execução e o status é íntegro.

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

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

4. No Swagger IDE, execute uma solicitação de GET para todas as linhas na tabela do products SQL do Azure.

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

6. Observe o aplicativo Web em execução e revise os dados de saída.

   

Limpeza

Quando já não precisar da aplicação ou dos recursos de amostra, remova a implementação correspondente e todos os recursos.

1. Remova a implantação da sua assinatura do Azure.

   azd down
   

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