Veri API oluşturucusu sürüm 1.5 'teki yenilikler (Nisan 2025)

Veri API oluşturucusu (DAB) sürüm 1.5 için sürüm notları ve güncelleştirmeler
Sürüm 1.5: Azure Veritabanları için Veri API oluşturucusu

Giriş: Sağlık Uç Noktası

Bu sürüm, DAB'nin çalışma süresini nasıl ilettiğini geliştirir. Daha önce kök URL basit bir sağlık kontrolü sonucu döndürdü.

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

Bu yanıt, doğrulamanın (benzeri dab validate) çalıştığını ve altyapının etkin olduğunu gösterir, ancak veri kaynaklarının veya uç noktaların gerçek durumunu yansıtmaz.

Şimdi uç nokta temel /health yapılandırma ayrıntılarını ve sistem durumu denetimlerini içerir:

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

Denetimler, tanımladığınız eşikleri kullanarak her veri kaynağının ve uç noktanın (REST ve GraphQL) kullanılabilirliğini ve yanıt hızını doğrular.

Uç Nokta Güvenliği

Sağlık uç noktaları, DAB'ın rol tabanlı erişim modelini izler. Denetimler, ayarlara bağlı olarak paralel veya sıralı olarak çalışır ve yoklama yükünü azaltmak için yanıtlar önbelleğe alınır.

Giriş: NOSQL için Azure Cosmos DB Için Şema Çıkarımı

Azure Data API Builder'da (DAB) yapılan bu geliştirme, doğrudan Azure CosmosDB NOSQL API koleksiyonlarından otomatik şema oluşturmaya olanak tanır. Daha önce, kullanıcıların schema.gql dosyasını kullanarak şemayı el ile tanımlaması gerekiyordu. Yeni özellik sayesinde şema oluşturma, cli aracılığıyla işlenebilir, yapılandırmayı hızlandırabilir ve veritabanı yapısı hakkında önceden bilgi sahibi olma gereksinimini azaltabilir. Daha fazla bilgi için bkz . Hızlı Başlangıç: NoSQL ile Veri API oluşturucusu kullanma.

Giriş: Özel Log-Level

DAB artık yapılandırılabilir düzeylerde günlüğü destekliyor. Genel bir varsayılan ayarlayıp ad alanı başına geçersiz kılabilirsiniz:

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

Ad alanı başına geçersiz kılmalarla:

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

production içinde, Anında Yeniden Yükleme özelliği log-level dinamik güncellemeleri destekler. Diğer yapılandırma değişiklikleri yoksayılır, ancak günlük seviyesindeki değişiklikler hemen geçerli olur; sorunları canlı olarak tanılamak için idealdir.
Daha.

Giriş: GraphQL'de toplama

DAB artık Microsoft SQL Server (MSSQL) için GraphQL sorgularında gruplandırma ve toplama işlemlerini destekliyor. Daha fazla arka uç mantığı olmadan özetler ve içgörüler oluşturabilirsiniz.

Özellik:

  • Toplama Türleri: SUM, AVG, MIN, MAX
  • GroupBy Desteği: Sonuçları alanlara göre gruplandırma
  • MSSQL için iyileştirilmiş: Verimli ve güvenilir sorgu yürütme
  • Geliştirilmiş Günlükler: Daha net şema oluşturma ve yürütme çıkışı

Aşağıdakiler arasında uygulanır:

HTTP Önbellek Üst Bilgileri

DAB artık şu desteği destekliyor:

Yönerge Anlamı
no-cache Önbelleğe alınan verileri yalnızca sunucuyla yeniden doğrulandıktan sonra kullanın
no-store Yanıtı hiç önbelleğe alma
only-if-cached Yalnızca önbelleğe alınmış verileri kullanın; kullanılamıyorsa başarısız olur

Daha.

Gelişmiş: OpenTelemetry

Daha önce DAB yalnızca varsayılan ASP.NET Çekirdek aralıklarını destekliyor. Bu sürüm REST ve GraphQL için özel yayılma alanları ve ölçümler ekler.

Ölçümler:

  • Etkin İstekler: Çalışan isteklerin gerçek zamanlı sayısı
  • Toplam İstek Sayısı: Başlangıçtan bu yana birikmeli sayı
  • Toplam Hatalar: Toplu hatalar ve özel durumlar

Bu ölçümler çalışma zamanı davranışına yönelik görünürlüğü artırır ve daha derin telemetri için temel oluşturur.

Gelişmiş: Entra Id Kimlik Doğrulama Sağlayıcısı

DAB başlangıçta Azure Active Directory'yi yapılandırmak için AzureAd enum'u kullanıyordu. Microsoft, entra id olarak yeniden adlandırmıştır.

Bu sürüm tercih edilen değer olarak tanıtıyor EntraId . Eski sabit listesi (AzureAd) geriye dönük uyumluluk için hala çalışır, ancak EntraId geçerli marka kimliğiyle uyumludur.

  • Last updated on