Aracılığıyla paylaş

GraphQL için Microsoft Fabric API'sinin sınırlamaları

Microsoft Fabric'te GraphQL api'sine yönelik geçerli genel ürün sınırlamaları bu makalede listelenmiştir. GraphQL için API'yi yeni özelliklerle sürekli geliştiriyoruz. Microsoft Fabric'in geleceği hakkında daha fazla bilgi için bkz. Fabric Yol Haritası.

Sınırlamaları kimlerin anlaması gerekiyor?

GraphQL API sınırlamalarını anlamak aşağıdakiler için çok önemlidir:

  • Fabric GraphQL API kısıtlamaları içinde çalışan uygulamalar tasarlayan uygulama geliştiricileri
  • Veri mühendisleri veri açığa çıkarma stratejilerini planlama ve platform sınırlarını anlama
  • Çözüm mimarları , Doku tabanlı çözümlerin kapsamını belirler ve uygun teknik beklentileri belirler
  • Doku çalışma alanı katkıda bulunanları sorunları giderme ve geçerli sınırlamalar için geçici çözümler uygulama
  • Proje yöneticileri, proje planlama sırasında paydaşlara Fabric platformu kısıtlamalarını iletir.

GraphQL API uygulamalarını planlarken veya beklenmeyen API davranışıyla ilgili sorunları giderirken bu sınırlamaları gözden geçirin.

Veri kaynağı işlemleri

SQL Analytics Uç Noktası veri kaynakları yalnızca okuma işlemlerini destekler. SQL Analytics Uç Noktaları (Lakehouses ve yansıtılmış veritabanları gibi) aracılığıyla erişilen veri kaynakları mutasyonları desteklemez. Verileri sorgulayabilirsiniz ancak GraphQL API'sini kullanarak kayıt oluşturamaz, güncelleştiremez veya silemezsiniz.

Boyut ve performans sınırları

Aşağıdaki tabloda anahtar boyutu, sayfalandırma ve performans kısıtlamaları özetlemektedir:

Sınır türü Değer Description Geçici çözüm
Varsayılan sayfa boyutu 100 öğe Varsayılan olarak istek başına döndürülen en fazla öğe sayısı Daha büyük sonuç kümelerini yinelemek için GraphQL sayfalandırmayı kullanma
En büyük sayfalama boyutu 100.000 öğe Sayfalandırma aracılığıyla alınabilecek en fazla toplam öğe sayısı 100.000'den fazla öğeye (GraphQL'de yaygın olmayan desen) ihtiyacınız varsa birden çok filtrelenmiş istek gönderme
En büyük yanıt boyutu 64 MB API yanıt yükünün en büyük boyutu Daha küçük öbeklerdeki verileri almak için birden çok filtrelenmiş istek verme
İstek zamanaşımı 100 saniye Tek bir istek için en uzun yürütme süresi Sorguları iyileştirme veya karmaşık işlemleri daha küçük isteklere bölme
En fazla sorgu derinliği 10 düzey Sorgudaki alanların iç içe yerleştirme düzeyi üst sınırı Aşırı veri getirme nedeniyle oluşan performans sorunlarını önlemek için sorgu iç içe yerleştirmeyi azaltın.

Saklı yordam sınırlamaları

Azure SQL, Dokudaki SQL Veritabanı ve Veri Ambarları'ndaki saklı yordamların belirli kısıtlamaları vardır:

  • Sonuç kümesi işleme: Yalnızca saklı yordam tarafından döndürülen ilk sonuç kümesi kullanılır. Birden çok sonuç kümesi desteklenmez.
  • Meta veri gereksinimleri: Yalnızca ilk sonuç kümesinin meta verilerinin sys.dm_exec_describe_first_result_set ile açıklanabileceği saklı yordamlar desteklenir.
  • Parametre önceliği: Hem yapılandırma dosyasında hem de URL sorgu dizesinde saklı yordam parametresi belirtildiğinde, URL sorgu dizesi değeri öncelikli olur.
  • Sınırlı GraphQL özellikleri: Saklı yordamlar tarafından desteklenen varlıklar, tablo veya görünüm destekli varlıklara kıyasla daha az özelliğe sahiptir:
    • Sayfalama desteği yok
    • Sıralama veya filtreleme yok
    • Birincil anahtar tabanlı arama yok

Bilinen sorunlar

GraphQL api'sindeki bilinen sorunlar için Microsoft Fabric Bilinen Sorunlaradresini ziyaret edin.

İlgili içerik

  • Last updated on