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. Kullanılabilir verileri net bir şekilde açıklamak için güçlü bir tür sistemi kullanır, hassas isteklere izin vererek aşırı getirmeyi azaltır, mevcut kodu bozmadan API güncelleştirmelerini kolaylaştırır ve ç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'si, Microsoft Fabric Veri Ambarları, Microsoft Fabric Lakehouses, Microsoft Fabric Yansıtılmış Veritabanları, Microsoft Fabric SQL Veritabanı ve Azure SQL Veritabanı s gibi veri kaynaklarınızdaki verilere erişmek için saniyeler içinde bir GraphQL API'sini oluşturmanıza olanak tanıyan yönetilen bir hizmettir. 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ı söz konusu olduğunda 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. 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. Şu anda çözümleyicileri ö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?
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ütmek için yeterli şekilde kaydedilmesi ve yapılandırılması gerekir. 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. Microsoft Entra'ya ek olarak, API çoklu oturum açma (SSO) kullanacak şekilde yapılandırılmışsa, GraphQL API'sini çağıran uygulamadaki kimliği doğrulanmış kullanıcı veya hizmet sorumlusu hem GraphQL API'sine hem de veri kaynağına erişim gerektirir . Daha belirgin olarak GraphQL API'sinde Sorgular ve Mutasyonlar Çalıştırma izni ve buna göre tercih ettiğiniz veri kaynağında okuma veya yazma erişimi gerekir. Bir diğer seçenek de kullanıcının veya hizmet sorumlusunun hem API'nin hem de veri kaynağı öğelerinin bulunduğu katkıda bulunan rolüne sahip bir çalışma alanı üyesi olmasıdır ve bu da 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. Alternatif olarak, 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şimi olmalıdır (API'ye doğrudan erişim izinleri eklerken Sorguları ve Mutasyonları
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. Ancak gelecekte bu özelliği desteklemeyi planlıyoruz ve kullanıma sunulduklarında güncelleştirmeler sağlayacağız.
Doku kiracım için Özel Bağlantı'nın etkinleştirilmesini sağladım. GraphQL öğelerim neden çalışmıyor?
"Genel İnternet erişimini engelle" kiracı ayarı etkinse (genel erişim devre dışı bırakılır), GraphQL API'si de dahil olmak üzere desteklenmeyen tüm yapıtlar veya öğeler otomatik olarak devre dışı bırakılır. Bu, daha önce oluşturulan öğelere erişilemeyecek veya yeni öğeler oluşturulamaz anlamına gelir. Bu öğelere erişmenin tek yolu genel erişime izin vermektir.
İsteğimi ilk kez yayımladığım zaman neden kötü performans sergiledikten sonra sonraki isteklerde iyi performans sergiliyorum?
Bu davranışın iki ana nedeni vardır. İlk olarak, bir veri kaynağının soğuk olması durumunda ısıtılması gerekiyorsa ilk istek daha uzun sürebilir. Veri kaynağı soğuk olmasa bile, veri kaynağında gerekli veriler belleğe yüklenmemişse GraphQL sorguyu ilk kez çalıştırdığı zaman veri alma işlemi o kadar verimli olmayabilir. İkinci neden, Sistemin istekleri kabul etmeye hazır olması için şemanızı ve yapılandırmanızı yüklemesi gerektiğinden GraphQL uç noktasına yönelik bir API'ye yapılan ilk isteğin daha uzun sürebileceğidir. Bu tek seferlik bir maliyettir ve sistem zaten hazır olduğundan 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.