Compartir a través de

Novedades de Data API Builder, versión 1.5 (abril de 2025)

Notas de la versión y actualizaciones de Data API Builder (DAB) versión 1.5
Versión 1.5: Generador de API de datos para bases de datos de Azure

Introducción: Punto de comprobación de salud

Esta versión mejora la forma en que DAB comunica su estado en tiempo de ejecución. Anteriormente, la dirección URL raíz devolvía un resultado de salud simple.

{
  "status": "Healthy",
  "version": "1.5.50",
  "app-name": "dab_oss_1.5.50"
}

Esa respuesta muestra que la validación (similar a dab validate) se ejecuta y el motor está activo, pero no refleja el estado real de los orígenes de datos o los puntos de conexión.

Ahora, el /health punto de conexión incluye detalles básicos de configuración y comprobaciones de estado:

{
  "status": "Unhealthy",
  "version": "1.5.50",
  "app-name": "dab_oss_1.5.50",
  "configuration": {
    "rest": true,
    "graphql": true,
    "caching": false,
    "telemetry": false,
    "mode": "Development"
  },
  "checks": []
}

Comprueba la disponibilidad y la capacidad de respuesta de cada origen de datos y punto de conexión (REST y GraphQL) mediante umbrales definidos.

Seguridad de los puntos de conexión

Los puntos de acceso de salud siguen el modelo de acceso basado en roles de DAB. Las comprobaciones se ejecutan en paralelo o secuencialmente en función de la configuración y las respuestas se almacenan en caché para reducir la carga del sondeo.

Presentamos: Log-Level personalizado

DAB ahora admite niveles de registro configurables. Puede establecer un valor predeterminado global e invalidarlo por espacio de nombres:

{
  "runtime": {
    "telemetry": {
      "log-level": {
        "default": "trace | debug | information | warning | error | critical | none"
      }
    }
  }
}

Con invalidaciones por espacio de nombres:

{
  "runtime": {
    "telemetry": {
      "log-level": {
        "default": "warning",
        "Azure.DataApiBuilder.Service": "information",
        "Azure.DataApiBuilder.Engine.Authorization": "error",
        "Microsoft.AspNetCore": "none"
      }
    }
  }
}

En production, la función Hot Reloads admite actualizaciones dinámicas en log-level. Se omiten otros cambios de configuración, pero los cambios de nivel de registro se aplican inmediatamente, ideales para diagnosticar problemas en directo.
Más.

Introducción: Agregación en GraphQL

DAB ahora admite operaciones de agrupación y agregación en consultas graphQL para Microsoft SQL Server (MSSQL). Puede generar resúmenes e información sin más lógica de back-end.

Características:

  • Tipos de agregación: SUM, AVG, MIN, MAX
  • Compatibilidad con GroupBy: agrupar los resultados por campos
  • Optimizado para MSSQL: ejecución eficaz y confiable de consultas
  • Registros mejorados: Generación de esquemas y salida de ejecución más claros

Implementado en:

Encabezados de caché HTTP

DAB ahora admite:

Directiva Significado
no-cache Usar datos almacenados en caché solo después de volver a validar con el servidor
no-store No almacene en caché la respuesta en absoluto
only-if-cached Usar solo datos almacenados en caché; produce un error si no está disponible

Más.

Mejorado: OpenTelemetry

Anteriormente, DAB solo admitía intervalos predeterminados de ASP.NET Core. Esta versión agrega intervalos y métricas personalizados para REST y GraphQL.

Métricas:

  • Solicitudes activas: recuento en tiempo real de solicitudes en ejecución
  • Total de solicitudes: recuento acumulado desde el inicio
  • Total de errores: errores acumulativos y excepciones

Estas métricas mejoran la visibilidad del comportamiento en tiempo de ejecución y colocan la base para una telemetría más profunda.

Mejorado: Proveedor de autenticación de Entra ID

DAB usó originalmente la AzureAd enumeración para configurar Azure Active Directory. Microsoft ha cambiado el nombre a Entra ID.

Esta versión presenta EntraId como valor preferido. La enumeración antigua (AzureAd) sigue funcionando por compatibilidad hacia atrás, pero EntraId se alinea con la marca actual.