Inicio rápido: Conéctese App Builder con el Generador de API de datos de Microsoft para cualquier base de datos

¿Desea conectar rápidamente su base de datos a App Builder y comenzar a crear aplicaciones con todas las funciones con API REST? Esta guía lo guiará a través del uso de Data API Builder (DAB) de Microsoft para crear una API REST a partir de cualquier base de datos compatible (SQL Server, MySQL, PostgreSQL y más), y luego conectarla directamente a App Builder.

¿Por qué utilizar Data API Builder?

El DAB de Microsoft proporciona una forma rápida y flexible de exponer su base de datos a través de REST o GraphQL sin escribir un backend. Esto es lo que obtienes de la caja:

• Puntos de conexión REST: GET, POST, PUT,, PATCH​ ​DELETE
• Filtrado, clasificación, paginación
• Soporte OpenAPI (Swagger)
• Funciona con tablas, vistas, procedimientos almacenados
• Almacenamiento en caché en memoria
• Código abierto y de uso gratuito

Paso 1: Instalar la CLI de Data API Builder

Instale la CLI de DAB globalmente mediante .NET:

dotnet tool install -g Microsoft.DataApiBuilder

Si ya está instalado:

dotnet tool update -g Microsoft.DataApiBuilder

Para obtener más detalles, consulte la documentación oficial de los documentos de instalación de DAB.

Paso 2: Configura tu base de datos

Necesitará una base de datos lista para usar: SQL Server, MySQL o PostgreSQL. Utilice SQL Server Management Studio, MySQL Workbench o su herramienta de base de datos preferida para poner en marcha uno.

En este ejemplo, usaremos una base de datos MSSQL.

Paso 3: Inicializar la configuración de DAB

Cree un archivo de configuración de línea base con la cadena de conexión:

dab init --database-type "mssql" --host-mode "Development" --connection-string "Server=YOUR_SERVER;Database=YOUR_DB;Integrated Security=True;"

A continuación, agregue una entidad:

dab add Products --source "Products" --permissions "anonymous:*"

Esto agrega un punto de conexión REST para la Products tabla. Ahora puede interactuar con él a través de /api/Products.

Habilite CORS si es necesario:

jsonCopyEdit"origins": ["*"]

Este es el aspecto que tendría tu básico dab-config.json (simplificado para mayor claridad):

{
  "data-source": {
    "database-type": "mssql",
    "connection-string": "Server=YOUR_SERVER;Database=NorthwindCRUD;Integrated Security=True;"
  },
  "runtime": {
    "rest": {
      "enabled": true,
      "path": "/api"
    },
    "host": {
      "cors": {
        "origins": ["*"]
      },
      "authentication": {
        "provider": "StaticWebApps"
      },
      "mode": "development"
    }
  },
  "entities": {
    "Products": {
      "source": {
        "object": "Products",
        "type": "table"
      },
      "rest": { "enabled": true },
      "permissions": [
        {
          "role": "anonymous",
          "actions": [{ "action": "*" }]
        }
      ]
    }
  }
}

Paso 4: Ejecutar y probar la API

Inicie la API con:

dab start

Verás resultados como:

Now listening on: http://localhost:5000

Visite http://localhost:5000/swagger/index.html para probar los puntos de conexión en la interfaz de usuario de Swagger.

Paso 5: Conéctate a App Builder

Ahora que su API está activa y Swagger está habilitado, puede llevarla fácilmente a App Builder.

Siga esta guía paso a paso

Consejos para la solución de problemas

Problema	Solución
🔄 Problemas de CORS	Añade "origins": ["*"] en tu host.cors sección
❌ DELETE no funciona	Compruebe si "permissions": "anonymous:*" incluye DELETE
🔐 Problemas de autenticación	Asegúrese de que la cadena de conexión use el método de autenticación correcto
🧩 Falta el formulario CRUD	El componente de formulario necesita más de OpenAPI, en progreso
🔑 ¿Necesita OIDC?	Seguimiento del problema de GitHub de OpenID Connect

Conclusión

En solo unos pocos pasos, ha creado y probado una API REST a partir de su base de datos y la ha conectado a App Builder. Ya sea que trabaje con bases de datos heredadas o comience de nuevo, Data API Builder lo ayuda a moverse rápido y App Builder da vida a su front-end.

Puede ver nuestro seminario web para ver cómo manejar la integración de bases de datos sin problemas utilizando Data API Builder.

Recursos adicionales

• Uso de datos en la aplicación (documentos oficiales)
• Integración de Form Builder
• Paginación remota de cuadrícula
• Guía de operaciones de CRUD
• Sistema de diseño flexible