GraphQL için Fabric API performans en iyi uygulamaları

GraphQL için Microsoft Fabric API'si verileri verimli bir şekilde sorgulamak için güçlü bir yol sunar, ancak sorunsuz ve ölçeklenebilir performans sağlamak için performans iyileştirmesi önemlidir. Karmaşık sorguları işlerken veya yanıt sürelerini en iyi duruma getirirken, aşağıdaki en iyi yöntemler GraphQL uygulamanızda en iyi performansı elde etmenize ve Doku'da API verimliliğinizi en üst düzeye çıkarmanıza yardımcı olur.

Bölgeler

Bölgeler arası çağrılar genellikle yüksek gecikme süresinin nedeni olabilir. En iyi performansı elde etmek için istemcilerin aynı kiracı ve kapasite bölgesindeki API'lere bağlanması önerilir.

Kiracı bölgesi

Kiracı bölgenizi aşağıdaki adımlarla bulabilirsiniz:

1. Bir yönetici hesabıyla Microsoft Fabric portalına gidin ve sağ üst köşedeki Yardım ? simgesine tıklayın.
2. Yardım bölümünün en altında Doku Hakkında bağlantısına tıklayın.
3. Bölge de dahil olmak üzere kiracınızla ilgili ayrıntılar görüntülenir.

Kapasite bölgesi

1. Microsoft Fabric portalına gidin, GraphQL için Doku API'nizi barındıran çalışma alanını açın.

2. Çalışma alanı ayarlarındanLisans bilgileri'ne gidin.

3. Kapasite bölgesi bilgilerinizi Lisans kapasitesi altında bulabilirsiniz.

   

Veri kaynağı bölgesi

1. Veri kaynağınız Doku platformunda barındırılıyorsa, çalışma alanının kapasite bölgesi veri kaynağı bölgesi olacaktır.

2. Veri kaynağınız Doku platformunun dışındaysa (örneğin, bir Azure SQL veritabanı), bölgesel bilgileri Azure portalında bulabilmelisiniz.

Performans testleri

API performanslarını değerlendiren müşteriler için tutarlı ve güvenilir sonuçlar elde etmek için aşağıdaki yönergelere uymanızı öneririz.

İstemci tarafı araçları

Uygulamanızın dolap davranışını taklit etmek için performansı ölçmek amacıyla betik veya tanıtım web uygulamasıyla test yapmanız önerilir. Buna ek olarak, HTTP bağlantı havuzunun kullanılması özellikle bölgeler arası senaryolarda gecikme sürelerini büyük ölçüde azaltabilir.

Başlamanıza yardımcı olabilecek bu örnek performans testi betiğini kullanabilirsiniz.

İlgili makaleler:

• Gelişmiş Kullanım—İstekler 2.32.3 belgeleri

• .NET için HttpClient yönergeleri

Veri toplama ve değerlendirme

Betikleri veya performans testi araçlarını kullanarak iyi tanımlanmış bir zaman aralığında istek yürütmeyi otomatikleştirmeniz önerilir. Ortalama veya yüzdebirlik tabanlı sonuçları analiz etmek, daha doğru ve taraflı olmayan performans ölçümleri sağlamaya yardımcı olur.

Yaygın sorunlar

API gecikme süresini ve performansını etkileyebilecek yaygın sorunların listesi aşağıda verilmiştır.

• İstemci coğrafi konumunuz kiracınızdan ve kapasite bölgenizden farklıdır:

  • Uygulamanız için en iyi performansı elde etmek istiyorsanız, istemcilerin ve API kaynaklarının aynı bölgede olması hedefe ulaşmanıza yardımcı olur.

• Test etmeden önce GraphQL için API'yi birkaç kez sorgula:

  • GraphQL API'si boşta olduğunda kapasiteyi (CU) kullanmaz. Başka bir deyişle, API ortamının ilk çağrı sırasında dahili olarak başlatılması gerekir ve bu işlem birkaç saniye daha sürer. GraphQL api'si, sürekli çağrıların gecikme sürelerini azaltmaya yardımcı olmak için dahili önbelleğe alma mekanizmalarına sahiptir, ancak ilk çağrılarda gecikme süresi artışlarıyla karşılaşabilirsiniz.
  • API'nin kendisi dışında, bazı veri kaynaklarının bir ısınma aşamasından geçtiği bilinmektedir ve bu da ilk isteklerde daha yüksek gecikme süresine neden olur. API aynı zamanda boşta olan bir veri kaynağına erişiyorsa ve ilk yürütme sırasında da başlatılması gerekiyorsa, hem veri kaynağının hem de API'nin başlatılmasını beklemesi gerektiğinden gecikme süresi daha yüksektir.
  • Ortam başlatma yalnızca bir kez gerçekleştiğinden sonraki çağrılar daha hızlıdır.

• Veri kaynağı ve Ağ yapısı kapasitesiyle ilgili kurulum.

  • GraphQL api'sini veri kaynaklarınızın üzerinde bir sarmalayıcı olarak düşünebilirsiniz. Veri kaynağınızın karmaşıklığı nedeniyle performans sorunları varsa API gecikme sürelerinin yüksek olması beklenir. Böyle durumlar olduğunda, GraphQL için API ile daha etkili bir performans karşılaştırması için veri kaynaklarınızı doğrudan sorgulamayı test etmek önerilir.

    • İş gereksinimlerinize uygun bir veri deposu seçmeyle ilgili bu kılavuzu izleyin: Fabric karar kılavuzu – veri deposu seçimi

  • GraphQL için API'ye eriştiğinizde, performans seçeceğiniz Fabric kapasite SKU'su ile sınırlı olacaktır.

    • Fabric kapasite SKU'su ve işlem gücü hakkında genel kılavuz için şuraya bakın: Microsoft Fabric kavramları

API performansını çeşitli faktörler etkileyebilir. İyileştirme için veri kaynağı kurulumunuzu anlamak, doğru bölgeleri seçmek ve performansı etkili bir şekilde ölçmek çok önemlidir.

İlgili içerik

• GraphQL için Fabric API'ye genel bakış
• GraphQL düzenleyicisi için Platform API'si