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

Bu makalede GraphQL için Microsoft Fabric API'sindeki geçerli sınırlamalar ayrıntılı olarak açıklanmaktadır.

Sınırlama

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ı.

• Erişim için bir SQL Analytics Uç Noktasından yararlanan tüm veri kaynakları yalnızca buna karşı okuma işlemlerini destekler. Örneğin, mutasyonlar Lakehouse'lar veya yansıtılmış veritabanları için kullanılamaz.

• Geçerli varsayılan sayfa boyutu 100'dür, yani her istek yanıtta en fazla 100 öğe döndürür. Sonuç kümeniz 100'den büyükse, GraphQL sayfalandırmakullanarak sonuçlar arasında yineleme yapın.

• En büyük sayfalama boyutu 100.000'dir. Bu, bir isteğin döndüreceği sabit en fazla öğe sayısı olduğu ve yineleme gerçekleştirebilmeniz anlamına gelir. Uygulamanız için 100.000'den fazla öğe döndürmeniz gerekiyorsa birden çok istek gönderin. Bu desenin GraphQL'de yaygın olmadığını anlayın.

• Desteklediğimiz maksimum yanıt boyutu 64 MB'tır. Bu, yanıt boyutu 64 MB'tan büyük olan tüm API isteklerinin hata döndüreceği anlamına gelir. Bu sınırlamayı geçici olarak çözmek için birden çok filtrelenmiş istek yayımlayabilirsiniz.

• Depolanan Prosedürler için Sınırlamalar (Azure SQL, Fabric içindeki SQL Veritabanı ve Veri Ambarları için geçerlidir)

  • API tarafından GraphQL için yalnızca saklı prosedür tarafından döndürülen ilk sonuç kümesi kullanılır.
  • İlk sonuç kümesi için sys.dm_exec_describe_first_result_set tarafından açıklanan meta verileri desteklenen yalnızca saklı yordamlar kullanılabilir.
  • Hem yapılandırma dosyasında hem de URL sorgu dizesinde saklı yordam parametresi belirtildiğinde, URL sorgu dizesindeki parametre önceliklidir.
  • Saklı yordam tarafından desteklenen varlıklar, tablolar veya görünümler tarafından desteklenen varlıklar için otomatik olarak sağlanan tüm özelliklere sahip değildir.
  • Saklı yordam destekli varlıklar sayfalandırmayı, sıralamayı veya filtrelemeyi desteklemez. Bu tür varlıklar, birincil anahtar değerleri tarafından belirtilen öğeleri döndürmeyi desteklemez.

• İstek zaman aşımı şu anda 100 saniyedir. Başka bir deyişle, tamamlanması 100 saniyeden uzun süren bir veri kaynağı sorgusu oluşturan bir istek oluşturursanız isteğiniz başarısız olabilir ve hata verebilir.

• Desteklenen sorgu derinliği üst sınırı 10'dur. Sorgu derinliği, sorgudaki alanların iç içe yerleştirme düzeyidir ve bu da olası özyineleme ve aşırı veri getirme nedeniyle çok derin olduğunda performansı etkileyebilir.

Bilinen sorunlar

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

İlgili içerik

• GraphQL için API'ye Genel Bakış
• GraphQL için Uygulamaları Doku API'sine bağlama
• GraphQL için API Sık Sorulan Sorular