Dela via

Nyheter i Data API Builder version 1.5 (april 2025)

Viktig information och uppdateringar för Data API Builder (DAB) version 1.5
Version 1.5: Data-API-byggare för Azure Databases

Introduktion: Hälsoslutpunkt

Den här versionen förbättrar hur DAB kommunicerar sitt körningstillstånd. Tidigare returnerade rot-URL:en ett enkelt hälsoresultat:

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

Svaret visar att valideringen (liknar dab validate) körs och att motorn är aktiv , men den återspeglar inte den faktiska hälsan för datakällor eller slutpunkter.

/health Slutpunkten innehåller nu grundläggande konfigurationsinformation och hälsokontroller:

{
  "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": []
}

Kontrollerar tillgängligheten och svarstiden för varje datakälla och slutpunkt – REST och GraphQL – med hjälp av tröskelvärden som du definierar.

Slutpunktssäkerhet

Hälsoslutpunkter följer DAB:s rollbaserade åtkomstmodell. Kontroller körs parallellt eller sekventiellt beroende på inställningar, och svar cachelagras för att minska belastningen från avsökning.

Introduktion: Schemainferens för Azure Cosmos DB för NOSQL

Den här förbättringen av Azure Data API Builder (DAB) gör det möjligt att skapa automatiserade scheman direkt från Azure CosmosDB NOSQL API-samlingar. tidigare var användarna tvungna att manuellt definiera schemat med hjälp av en schema.gql-fil. Med den nya funktionen kan schemagenerering hanteras via cli, effektivisera konfigurationen och minska behovet av grundläggande kunskaper om databasstrukturen. Läs mer

Presenterar: Anpassad Log-Level

DAB stöder nu konfigurerbara loggningsnivåer. Du kan ange ett globalt standardvärde och åsidosätta det per namnområde:

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

Med åsidosättningar per namnområde:

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

I production stöder funktionen Snabbladdning dynamiska uppdateringar till log-level. Andra konfigurationsändringar ignoreras, men ändringar på loggnivå tillämpas omedelbart – perfekt för att diagnostisera problem live.
Mer.

Introduktion: Sammansättning i GraphQL

DAB stöder nu grupperings- och aggregeringsåtgärder i GraphQL-frågor för Microsoft SQL Server (MSSQL). Du kan generera sammanfattningar och insikter utan mer serverdelslogik.

Funktioner:

  • Sammansättningstyper: SUM, AVG, MIN, MAX
  • GroupBy-stöd: Gruppera resultat efter fält
  • Optimerad för MSSQL: Effektiv och tillförlitlig frågekörning
  • Förbättrade loggar: Tydligare schemagenerering och körningsutdata

Implementerad över:

HTTP-cachehuvuden

DAB stöder nu:

Direktiv Innebörd
no-cache Använd endast cachelagrade data efter att ha återvaliderat med servern
no-store Cachea inte svaret överhuvudtaget
only-if-cached Använd endast cachelagrade data. misslyckas om den inte är tillgänglig

Mer.

Förbättrad: OpenTelemetry

Tidigare stödde DAB endast standardintervall för ASP.NET Core. Den här versionen lägger till anpassade intervall och mått för REST och GraphQL.

Mått:

  • Aktiva begäranden: Antal aktiva begäranden i realtid
  • Totalt antal begäranden: Ackumulerat antal sedan starten
  • Totalt antal fel: Kumulativa fel och undantag

Dessa mått förbättrar insynen i körningsbeteendet och lägger grunden för djupare telemetri.

Utökad: Entra ID-autentiseringsprovider

DAB använde ursprungligen AzureAd uppräkningen för att konfigurera Azure Active Directory. Microsoft har sedan dess bytt namn till Entra-ID.

Den här versionen introducerar EntraId som det föredragna värdet. Den gamla uppräkningen (AzureAd) fungerar fortfarande för bakåtkompatibilitet, men EntraId överensstämmer med den aktuella varumärkesanpassningen.