Inicio rápido: Uso de Data API Builder con Azure SQL y Azure Container Apps

En este inicio rápido, implementará Data API Builder (DAB) como contenedor de Docker en Azure Container Apps. Use una plantilla de la CLI para desarrolladores de Azure (AZD) para implementar DAB junto con una base de datos de Azure SQL mediante los procedimientos recomendados más recientes. La plantilla también implementa una aplicación web de ejemplo que se conecta al punto de conexión de DAB mediante GraphQL.

Prerrequisitos

• CLI para desarrolladores de Azure
• .NET 9.0

Si no tiene una cuenta de Azure, cree una cuenta gratuita antes de comenzar.

Inicialización del proyecto

Use la CLI para desarrolladores de Azure (azd) para crear una cuenta de Azure SQL, implementar DAB como una solución en contenedor e implementar una aplicación de ejemplo en contenedor. La aplicación de ejemplo usa DAB para consultar datos de ejemplo.

1. Abra un terminal en un directorio vacío.

2. Si aún no está autenticado, autentíquese en la CLI para desarrolladores de Azure mediante azd auth login. Siga los pasos especificados por la herramienta para autenticarse en la CLI mediante sus credenciales de Azure preferidas.

   azd auth login
   

3. Ejecute azd init para inicializar el proyecto.

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

4. Durante la inicialización, configure un nombre de entorno único.

5. Asegúrese de que Docker se ejecuta en la máquina antes de continuar con el paso siguiente.

6. Implemente la solución completa en Azure mediante azd up. Las plantillas de Bicep implementan una cuenta de Azure SQL de DAB en Azure Container Apps y una aplicación web de ejemplo.

   azd up
   

7. Durante el proceso de aprovisionamiento, seleccione la suscripción y la ubicación deseada. Espere a que se complete el proceso de aprovisionamiento. El proceso puede tardar aproximadamente siete minutos.

8. Una vez realizado el aprovisionamiento de los recursos de Azure, se incluye una dirección URL a la aplicación web en ejecución en la salida.

   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 los valores para la URL de la API y los servicios web . Estos valores se usan más adelante en esta guía.

Configuración de la conexión de base de datos

Ahora, vaya a cada aplicación en contenedor en Azure Container Apps para validar que funcionan según lo previsto.

1. En primer lugar, vaya a la dirección URL del servicio API de . Esta dirección URL vincula a la instancia de DAB en ejecución.

2. Observe la salida JSON de DAB. Debe indicar que el contenedor DAB está funcionando y el estado es saludable.

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

3. Acceda a la ruta de acceso relativa /swagger para la instancia DAB. Esta dirección URL debe abrir la interfaz de usuario de Swagger entorno de desarrollo integrado (IDE) rest.

4. En el IDE de Swagger, ejecute una solicitud de GET para todas las filas de la tabla de Azure SQL products.

5. Por último, navegue a la URL del servicio web . Esta dirección URL vincula a la aplicación web de ejemplo en ejecución que se conecta al punto de conexión de GraphQL al que ha accedido en el paso anterior.

6. Observe la aplicación web en ejecución y revise los datos de salida.

   

Limpieza

Cuando ya no necesite la aplicación o los recursos de ejemplo, quite la implementación correspondiente y todos los recursos.

1. Elimine la implementación de su suscripción de Azure.

   azd down
   

2. Elimine el espacio de código en ejecución para maximizar los derechos de almacenamiento y núcleo si usa GitHub Codespaces.

Paso siguiente

puntos de conexión REST