Veri API oluşturucusu sürüm 1.2 (Ağustos 2024) ile ilgili yenilikler

Veri API oluşturucusu (DAB) sürüm 1.2'deki güncelleştirmeler ve geliştirmeler hakkında sürüm notları ve bilgiler.
Sürüm 1.2.10: Azure Veritabanları için Veri API oluşturucusu

Önemli

Bu güncelleştirme, Mayıs ayında genel kullanıma sunulduğundan (GA) bu yana ilk önemli sürümümüzdür.

Giriş: Maksimum Sayfa Boyutu

Veri API oluşturucusu, REST ve GraphQL uç noktalarındaki sorgu sonuçlarını otomatik olarak sayfalandırır . Sayfalandırma, büyük tablolara yönelik sorguların yönetilebilir sonuçlar döndürmesini sağlar ve hem veritabanını hem de DAB'yi aşırı büyük yanıtlara karşı korur.

Varsayılan olarak, DAB 100 kayıtlarının sayfa boyutunu kullanır ve bu, default-page-size ayarı aracılığıyla yapılandırılabilir. Kullanıcılar, varsayılanı atlayarak anahtar sözcüğünü$first kullanarak daha fazla kayıt isteyebilir.

Kötüye kullanımı önlemek ve uç nokta performansının korunmasına max-page-size yardımcı olmak için DAB artık ayarı destekliyor ve bu ayar bir kullanıcının isteyebileceği maksimum kayıt sayısını kapsıyor. Bu seçenek geliştiricilere önemli korumalar eklerken denetim ve esneklik sağlar.

{
  "runtime": {
    "pagination": {
      "max-page-size": 1000,
      "default-page-size": 100
    }
  }
}

Giriş: Maksimum Yanıt Boyutu

Büyük sonuç kümeleri hem DAB'yi hem de veritabanını bunaltabilir. Sürüm 1.2, yanıt boyutunu megabayt olarak sınırlayan bir ayar sunar max-response-size-mb. Bu sınır, geniş sütunların (metin, ikili, XML, JSON) değer başına en fazla 2 GB tutabileceği için satır sayısına değil, gerçek yüke uygulanır.

Bu ayar, çeşitli veri türleri için esnekliği korurken çıkış boyutuna bir tavan uygulanarak performans ve sistem güvenilirliğinin sağlanmasına yardımcı olur.

{
  "runtime": {
    "host": {
      "max-response-size-mb": 158
    }
  }
}

Giriş: GraphQL Sorgu Derinliği Sınırı

GraphQL, ilişkiler aracılığıyla derin iç içe sorguları destekler ve bu da karmaşık veri alımını kolaylaştırır. Ancak derin iç içe yerleştirme sorgu karmaşıklığını artırır ve performansı düşürebilir.

graphql/depth-limit Yeni ayar, maksimum sorgu derinliğini kısıtlayarak işlevsellik ve güvenilirlik arasında bir denge sağlar.

{
  "runtime": {
    "graphql": {
      "depth-limit": 2
    }
  }
}

Çeşitli Geliştirmeler

• OpenAPI geliştirmeleri: Oluşturulan OpenAPI belgesine daha fazla meta veri ekleyerek Infragistics AppBuilder gibi araçlar için Geliştirilmiş OpenAPI uyumluluğu.
  Ayrıntılar

• Postgres telemetri desteği: application_name Artık, daha önce SQL Server'da olduğu gibi Postgres bağlantıları için ayarlanmıştır.
  Ayrıntılar

• Yeniden deneme ilkesi ayarlaması: Microsoft Learn en iyi yöntemlerini izlemek için varsayılan yeniden deneme sayısı 5'ten 3'e düşürüldü.
  Ayrıntılar

• Kültürel sabit veri dönüştürme: Veri mutasyonları artık float değerlerini işlerken yerel ayar tabanlı tutarsızlıkları önlemek için kullanılıyor CultureInfo.InvariantCulture .
  Ayrıntılar

• Şema doğrulaması sırasında ortam değişkeni çözümlemesi: Yapılandırmada kullanılan ortam değişkenleri (örneğin, bağlantı dizeleri) artık şema doğrulamadan önce doğru şekilde çözümleniyor.
  Ayrıntılar