GraphQL için sık sorulan Doku API'sine yönelik soruların yanıtlarını bulun.
GraphQL nedir?
GraphQL, uygulamaların tam olarak ihtiyaç duydukları verileri istemesine olanak tanıyan API'ler için bir sorgu dilidir. Başlıca avantajlar şunlardır:
- Güçlü tür sistemi - Kullanılabilir verileri açıkça açıklar
- Hassas veri getirme - Belirli isteklere izin vererek aşırı getirmeyi azaltır
- Geriye dönük uyumluluk - Mevcut kodu bozmadan API güncelleştirmelerini kolaylaştırır
- Gelişmiş araçlar - Geniş bir geliştirici araçları kümesinin kullanılmasını sağlar
Uygulamaların sunucularla ve veritabanlarıyla iletişim kurması için daha verimli bir yoldur.
GraphQL için Microsoft Fabric API nedir?
GraphQL için Microsoft Fabric API,saniyeler içinde GraphQL API'sini oluşturmanıza olanak tanıyan yönetilen bir hizmettir.
Desteklenen veri kaynakları:
- Microsoft Fabric veri ambarları
- Microsoft Fabric Lakehouses
- Microsoft Fabric Yansıtılmış Veritabanları
- Microsoft Fabric SQL Veritabanları
- Azure SQL veritabanları
Desteklenen bu veri kaynaklarından verileri sorgulamak ve değiştirmek için birleşik bir API katmanı sağlar.
GraphQL için Doku API'sinde hangi GraphQL işlemleri desteklenir?
Şu anda yalnızca GraphQL sorguları (okuma) ve mutasyonlar (yazma) desteklenmektedir. SQL Analytics Uç Noktaları aracılığıyla kullanıma sunulan veri kaynakları salt okunur olduğundan yalnızca Sorguları destekler. Veri Ambarları için mutasyonların otomatik olarak oluşturulması için birincil anahtarın tanımlanması gerekir.
GraphQL için Doku API'sinde çözümleyicileri nasıl görüntüleyebilir ve düzenleyebilirim?
Çözümleyiciler, API'deki alanları çözümlemek ve veri kaynaklarında bulunan verilerle işlemler gerçekleştirmek için iş mantığı sağlayan GraphQL bileşenleridir.
Otomatik oluşturma: Doku, yeni bir veri kaynağı eklediğinizde veya mevcut bir veri kaynağından kullanıma sunulacak yeni nesneleri seçtiğinizde otomatik olarak çözümleyiciler oluşturur.
Özelleştirme: Şu anda çözümleyicileri doğrudan özelleştirmek mümkün değildir. GraphQL için API'de özelleştirilmiş iş mantığı için veri kaynağında bir saklı yordam oluşturabilir ve GraphQL API'sinde kullanıma sunabilirsiniz.
GraphQL için API istemci uygulaması, sorgular veya mutasyonlar gerçekleştirmek için veri kaynağına access gerektirir mi?
GraphQL için Microsoft Entra ID authentication: API'si, uygulamaların kimlik doğrulaması için Microsoft Entra ID kullanmasını gerektirir. İstemci uygulamanızın Fabric'e karşı API çağrılarını yürütecek şekilde kaydedilmesi ve yapılandırılması gerekir.
Gerekli izinler:
- Microsoft Entra'da kayıtlı uygulama, Power BI service için GraphQLApi.Execute.All izinlerini gerektirir. Daha fazla bilgi için bkz. Azure'da Microsoft Entra uygulaması oluşturma.
Single oturum açma (SSO) yapılandırması: API, SSO kullanacak şekilde yapılandırılmışsa, kimliği doğrulanmış kullanıcı veya hizmet sorumlusu her ikisine de erişimi gerektirir:
- GraphQL API(Sorguları ve Mutasyonları Çalıştırma izni)
- Veri kaynağı (gerektiğinde okuma veya yazma erişimi)
Çalışma alanı düzeyinde erişim seçeneği: Alternatif olarak, kullanıcıyı veya hizmet prensibini hem API'nin hem de veri kaynağı öğelerinin bulunduğu katkıda bulunan rolüne çalışma alanı üyesi olarak atayın. Bu, her iki öğeye de tek bir yerden gerekli erişimi sağlar. Daha fazla bilgi için bkz. Kullanıcıların çalışma alanlarına erişim sağlamalarını.
Kaydedilmiş kimlik bilgileri yapılandırması: API, kaydedilmiş kimlik bilgilerini kullanacak şekilde yapılandırılmışsa, kimliği doğrulanmış kullanıcı veya hizmet sorumlusu yalnızca API'ye erişimi gerekir (API'ye doğrudan erişim izinleri eklerken Sorgular ve Mutasyonlar seçeneğini seçin).
Örnekler:Connect Applications'da hem kullanıcı sorumluları hem de hizmet sorumluları için örnek kod içeren uçtan uca bir örnek bulabilirsiniz.
GraphQL API'si için bir destek bileti nasıl açarım?
GraphQL için Fabric API'si ile ilgili herhangi bir sorunda Microsoft Destek'ten yardım almak için Fabric Destek sitemizi ziyaret edin ve Veri Mühendisliği seçeneğini belirleyin.
GraphQL için API Private Link destekliyor mu?
GraphQL için API şu anda yalnızca Kiracı Düzeyi Özel Bağlantı desteklemektedir.
İsteğimi ilk kez yayımladığım zaman neden kötü performans sergiledikten sonra sonraki isteklerde iyi performans sergiliyorum?
Bu "soğuk başlangıç" davranışının iki ana nedeni vardır:
Veri kaynağı ısınması:
- Bir veri kaynağının soğuk durumdan ısıtılması gerekiyorsa ilk istek daha uzun sürebilir
- Veri kaynağı soğuk olmasa bile, veri kaynağı belleğe gerekli veriler yüklenmemişse GraphQL sorguyu ilk kez çalıştırdığı zaman veri alma işlemi o kadar verimli olmayabilir
API uç noktası başlatma:
- Sistemin şemanızı ve yapılandırmanızı yüklemesi gerektiğinden GraphQL uç noktası için bir API'ye yapılan ilk istek daha uzun sürebilir
- Sistem zaten ısındığından ve isteklerinize hizmet etmeye hazır olduğundan sonraki istekler daha hızlıdır
Performans en iyi yöntemleri bölümünde daha fazla bilgi bulabilirsiniz.
GraphQL için API için nasıl geri bildirim veya öneriler sağlayabilirim?
Geri bildirimlerinizi ve önerilerinizi bekliyoruz! Doku Fikirleriaracılığıyla geri bildirim sağlayabilirsiniz. Ekibimiz bu platform aracılığıyla gönderilen geri bildirimleri ve önerileri etkin bir şekilde izler. Belirli sorgular veya endişeler için Microsoft Fabric Desteği aracılığıyla da bize ulaşabilirsiniz.