Inicio rápido: Uso de Data API Builder con Azure Cosmos DB para NoSQL y Azure Static Web Apps

2025-06-11

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 Cosmos DB para NoSQL 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 Cosmos DB para NoSQL, 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.

Abra un terminal en un directorio vacío.
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
```

Use azd init para inicializar el proyecto.

azd init --template dab-azure-cosmos-db-nosql-quickstart

Durante la inicialización, configure un nombre de entorno único.
Implemente la solución completa en Azure mediante azd up. Las plantillas de Bicep implementan una cuenta de Azure Cosmos DB para NoSQL DAB en Azure Container Apps y una aplicación web de muestra.
```
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 siete minutos.

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.

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.

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.
Observe la salida JSON de DAB. Debe indicar que el contenedor DAB está funcionando y el estado es saludable.
```
{
  "status": "healthy",
  "version": "1.1.7",
  "app-name": "dab_oss_1.1.7"
}
```
Acceda a la ruta de acceso relativa /graphql para la instancia DAB. Esta dirección URL debe abrir el entorno de desarrollo integrado (IDE) de Nitro GraphQL.
En el IDE de Nitro, cree un nuevo documento y ejecute esta consulta para obtener todos los 100 elementos del contenedor de products de Azure Cosmos DB para NoSQL.
```
query {
  products {
    items {
    id
    name
    description
    sku
    price
    cost
    }
  }
}
```
Por último, vaya 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.
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.

Elimine la implementación de su 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 de GraphQL