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
- Zengin araçlar - Çok çeşitli geliştirici araçlarının 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 kapatmak 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 erişim gerektiriyor mu?
Microsoft Entra Id kimlik doğrulaması: GraphQL 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 hizmeti için GraphQLApi.Execute.All izinleri gerektirir. Daha fazla bilgi için bkz . Azure'da Microsoft Entra uygulaması oluşturma.
Çoklu 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şim 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 sorumlusunu hem API'nin hem de veri kaynağı öğelerinin bulunduğu katkıda bulunan rolüne sahip bir çalışma alanı üyesi olarak atayın. Bu, her iki öğeye de tek bir yerden gerekli erişimi verir. Daha fazla bilgi için bkz . Kullanıcılara çalışma alanlarına erişim verme.
Kaydedilen kimlik bilgileri yapılandırması: API kaydedilmiş kimlik bilgilerini kullanacak şekilde yapılandırılmışsa, kimliği doğrulanmış kullanıcının veya hizmet sorumlusunun yalnızca API'ye erişmesi gerekir (API'ye doğrudan erişim izinleri eklerken Sorguları ve Mutasyonları Çalıştır seçeneğini belirleyin).
Ö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 için API için bir destek bileti açmak Nasıl yaparım??
GraphQL için Doku API'sine ilişkin herhangi bir sorunla ilgili Microsoft Desteği yardım almak için Doku Desteği sitemizi ziyaret edin ve Veri Madenciliği seçeneğini belirleyin.
GraphQL IÇIN API Özel Bağlantıyı destekliyor mu?
GraphQL IÇIN API şu anda Özel Bağlantıyı desteklemiyor.
İ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.