Inicio rápido: Uso del generador de API de datos con Azure SQL y Azure Static Web Apps

Artículo
10/29/2024

En este inicio rápido, implementará una plantilla de la CLI para desarrolladores de Azure (AZD). La plantilla implementa una aplicación web estática de Azure que hospeda el generador de Data API mediante su característica conexiones de base de datos. La plantilla también incluye una aplicación de ejemplo que puede usar como punto de partida para las soluciones.

Prerrequisitos

Suscripción de Azure. Si no tiene una suscripción de Azure, cree una cuenta de prueba gratuita
de .NET 8
de la CLI para desarrolladores de Azure

Propina

Como alternativa, abra este inicio rápido en GitHub Codespaces con todos los requisitos previos para desarrolladores ya instalados. Solo tiene que traer su propia suscripción de Azure. Las cuentas de GitHub incluyen un derecho de almacenamiento y horas básicas sin costo alguno. Para obtener más información, consulte incluidas las horas de almacenamiento y núcleo para las cuentas de GitHub.

Implementación de la plantilla

En primer lugar, implemente todos los servicios necesarios mediante la plantilla de AZD.

Abra un terminal en el directorio raíz del proyecto.
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
```
Use azd init para inicializar el proyecto.
```
azd init --template dab-azure-sql-quickstart
```
Importante

Si se ejecuta en GitHub Codespaces, puede omitir de forma segura el argumento --template, ya que el código ya se ha clonado en su entorno.
Durante la inicialización, configure un nombre de entorno único.

Propina

El nombre del entorno también se usará como nombre del grupo de recursos de destino. Para este inicio rápido, considere la posibilidad de usar msdocs-swa-dab.
Implemente la solución Azure Static Web Apps mediante azd up. Las plantillas de Bicep implementan una base de datos de Azure SQL junto con los servicios de almacenamiento, identidad y host compatibles. Se implementa una aplicación web de ejemplo en el host web.
```
azd up
```
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 cinco minutos.

Nota

No todos los servicios de Azure están disponibles en todas las regiones de Azure. Para más información, consulte productos de Azure por región.
Una vez realizado el aprovisionamiento de los recursos de Azure, la plantilla genera un mensaje SUCCESS junto con la duración de la ejecución.
```
SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.
```

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

Ahora, use la característica conexiones de base de datos de Azure Static Web Apps para crear una conexión entre la aplicación web estática implementada y la base de datos implementada. Esta característica usa data API Builder sin problemas para crear una conexión a una base de datos de Azure SQL en ejecución mediante las credenciales que especifique.

Vaya al recurso Azure Static Web App en Azure Portal.

Configure la aplicación web estática para agregar una conexión de base de datos a la base de datos de Azure SQL mediante estas opciones. A continuación, seleccione Vínculo.

	Valor
tipo de base de datos de	`Azure SQL Database`
de suscripción	Seleccione la suscripción que usó para la implementación de AZD
del grupo de recursos de	Seleccione el grupo de recursos (entorno) que usó para la implementación de AZD
nombre de recurso de	Seleccione el único recurso de SQL Server con un prefijo de `srvr-`*
de nombre de base de datos de	`adventureworkslt`
tipo de autenticación de	`User-assigned managed identity`
de identidad administrada asignada por el usuario	Seleccione el único recurso de identidad administrada con un prefijo de `ua-id-`

Captura de pantalla de la página de conexión de base de datos de una aplicación web estática en Azure Portal.

Ahora, seleccione la opción Examinar en la página de recursos para observar la ejecución de la aplicación web.

Limpiar

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

Quite la implementación de la suscripción de Azure.
```
azd down
```
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

Compartir a través de