Compartilhar via

Novidades no Construtor de API de Dados versão 1.5 (abril de 2025)

Notas de versão e atualizações do DAB (Construtor de API de Dados) versão 1.5
Versão 1.5: Construtor de API de Dados para Bancos de Dados do Azure

Introdução: Ponto de Extremidade de Saúde

Esta versão melhora a forma como o DAB comunica seu estado de runtime. Anteriormente, a URL raiz retornava um resultado de integridade simples:

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

Essa resposta mostra que a validação (semelhante a dab validate) é executada e o mecanismo está ativo, mas não reflete a integridade real de fontes de dados ou pontos de extremidade.

Agora, o /health endpoint inclui configuração básica e verificações de integridade.

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

As verificações validam a disponibilidade e a capacidade de resposta de cada fonte de dados e ponto de extremidade — REST e GraphQL — usando os limites definidos.

Segurança de Endpoint

Os pontos de saúde seguem o modelo de acesso baseado em função do DAB. As verificações são executadas em paralelo ou sequencialmente, dependendo das configurações, e as respostas são armazenadas em cache para reduzir a carga da sondagem.

Introdução: Inferência de esquema para o Azure Cosmos DB para bancos de dados NoSQL

Esse aprimoramento para o DAB (Construtor de API de Dados do Azure) permite a criação de esquema automatizado diretamente das coleções de API NOSQL do Azure CosmosDB. anteriormente, os usuários tinham que definir manualmente o esquema usando um arquivo schema.gql. Com a nova funcionalidade, a geração de esquema pode ser tratada por meio da CLI, simplificando a configuração e reduzindo a necessidade de conhecimento antecipado da estrutura do banco de dados. Leia mais

Introdução: Log-Level personalizado

O DAB agora dá suporte a níveis de log configuráveis. Você pode definir um padrão global e substituí-lo em cada namespace.

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

Com substituições por namespace:

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

Em production, a funcionalidade de Hot Reloads dá suporte a atualizações dinâmicas para log-level. Outras alterações de configuração são ignoradas, mas as alterações no nível do log se aplicam imediatamente — ideal para diagnosticar problemas ao vivo.
Mais.

Introdução: Agregação no GraphQL

O DAB agora dá suporte a operações de agrupamento e agregação em consultas GraphQL para Microsoft SQL Server (MSSQL). Você pode gerar resumos e insights sem mais lógica de back-end.

Características:

  • Tipos de agregação: SUM, , AVG, MIN, MAX
  • Suporte a GroupBy: agrupar resultados por campos
  • Otimizado para MSSQL: execução de consulta eficiente e confiável
  • Logs aprimorados: geração de esquema e saída de execução mais claras

Implementado em:

Cabeçalhos de cache HTTP

O DAB agora dá suporte a:

Diretiva Significado
no-cache Usar dados armazenados em cache somente após a revalidação com o servidor
no-store Não armazene a resposta em cache
only-if-cached Usar somente dados armazenados em cache; falhará se não estiver disponível

Mais.

Aprimorado: OpenTelemetry

Anteriormente, o DAB só tinha suporte ASP.NET intervalos principais padrão. Esta versão adiciona intervalos e métricas personalizados para REST e GraphQL.

Métricas:

  • Solicitações Ativas: contagem em tempo real de solicitações em execução
  • Total de Solicitações: Contagem cumulativa desde a inicialização
  • Total de erros: falhas e exceções cumulativas

Essas métricas melhoram a visibilidade do comportamento do runtime e estabelecem as bases para uma telemetria mais profunda.

Avançado: Provedor de Autenticação de ID do Entra

O DAB usou originalmente a enumeração para configurar o AzureAd Azure Active Directory. Desde então, a Microsoft renomeou-o para Entra ID.

Esta versão apresenta EntraId como o valor preferencial. A enumeração antiga (AzureAd) ainda funciona para compatibilidade com versões anteriores, mas EntraId está alinhada com a identidade visual atual.

  • Last updated on