Delen via

Wat is er nieuw in Data API Builder versie 1.5 (april 2025)

Opmerkingen bij de release en updates voor Data API Builder (DAB) versie 1.5
Release 1.5: Data API Builder voor Azure Databases

Inleiding: Gezondheidseindpunt

Deze release verbetert hoe DAB de runtimestatus communiceert. Voorheen retourneerde de hoofd-URL een eenvoudig statusresultaat:

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

Dit antwoord laat zien dat de validatie (vergelijkbaar met dab validate) wordt uitgevoerd en dat de engine actief is, maar niet de werkelijke status van gegevensbronnen of eindpunten weergeeft.

/health Het eindpunt bevat nu basisconfiguratiedetails en statuscontroles:

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

Controleert de beschikbaarheid en reactiesnelheid van elke gegevensbron en elk eindpunt( REST en GraphQL) met behulp van drempelwaarden die u definieert.

Eindpuntveiligheid

Gezondheidseindpunten volgen het op rollen gebaseerde toegangsmodel van DAB. Controles worden parallel of opeenvolgend uitgevoerd, afhankelijk van de instellingen en antwoorden worden in de cache opgeslagen om de belasting van polling te verminderen.

Inleiding: Schemadeductie voor Azure Cosmos DB voor NOSQL

Dankzij deze uitbreiding van Azure Data API Builder (DAB) kan automatisch schema rechtstreeks vanuit Azure CosmosDB NOSQL API-verzamelingen worden gemaakt. Eerder moesten gebruikers het schema handmatig definiëren met behulp van een schema.gql-bestand. Met de nieuwe mogelijkheid kan het genereren van schema's worden verwerkt via cli, stroomlijning van de configuratie en het verminderen van de behoefte aan vooraf kennis van de databasestructuur. Zie quickstart: Data API Builder gebruiken met Azure Cosmos DB for NoSQL voor meer informatie.

Inleiding: Aangepaste Log-Level

DAB ondersteunt nu configureerbare logboekregistratieniveaus. U kunt een globale standaard instellen en deze per naamruimte overschrijven:

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

Met overschrijvingen per naamruimte:

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

In productionondersteunt de functie Hot Reloads dynamische updates voor log-level. Andere configuratiewijzigingen worden genegeerd, maar wijzigingen op logboekniveau zijn onmiddellijk van toepassing, ideaal voor het diagnosticeren van problemen.
Meer.

Inleiding: Aggregatie in GraphQL

DAB ondersteunt nu groeperings- en aggregatiebewerkingen in GraphQL-query's voor Microsoft SQL Server (MSSQL). U kunt samenvattingen en inzichten genereren zonder meer back-endlogica.

Functies:

  • Aggregatietypen: SUM, AVG, MINMAX
  • Ondersteuning voor GroupBy: Resultaten groeperen op velden
  • Geoptimaliseerd voor MSSQL: Efficiënte en betrouwbare queryuitvoering
  • Verbeterde logboeken: duidelijkere generatie en uitvoer van het schema

Geïmplementeerd op:

HTTP Cache headers

DAB ondersteunt nu:

Richtlijn Betekenis
no-cache Gegevens in de cache alleen gebruiken nadat deze opnieuw zijn gevalideerd met de server
no-store Sla het antwoord helemaal niet in de cache op
only-if-cached Gebruik alleen gegevens in de cache; mislukt als deze niet beschikbaar is

Meer.

Uitgebreid: OpenTelemetry

Voorheen ondersteunde DAB alleen standaard ASP.NET Core-spanten. In deze release worden aangepaste spans en metrische gegevens toegevoegd voor REST en GraphQL.

Metrische gegevens:

  • Actieve verzoeken: realtime telling van lopende verzoeken
  • Totaal aantal aanvragen: cumulatief aantal sinds het opstarten
  • Totaal aantal fouten: cumulatieve fouten en uitzonderingen

Deze metrische gegevens verbeteren de zichtbaarheid van runtimegedrag en leggen de basis voor diepere telemetrie.

Uitgebreid: Entra ID Verificatieprovider

DAB heeft oorspronkelijk de AzureAd enum gebruikt om Azure Active Directory te configureren. Microsoft heeft de naam sindsdien gewijzigd in Entra-id.

Deze release introduceert EntraId als de voorkeurswaarde. Het oude enum (AzureAd) werkt nog steeds voor achterwaartse compatibiliteit, maar EntraId is afgestemd op de huidige huisstijl.

  • Last updated on