Inicio rápido: Uso del generador de API de datos con Azure SQL y Azure Static Web 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 empezar.

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

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

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

8. Registre los valores de la dirección URL de los servicios de api de y 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á en funcionamiento y el estado es correcto.

   {
     "status": "healthy",
     "version": "1.1.7",
     "app-name": "dab_oss_1.1.7"
   }
   

3. Vaya a la ruta de acceso relativa /swagger para la instancia de 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.

   

Limpiar

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

1. Quite la implementación de la 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