Aracılığıyla paylaş

GraphQL için Microsoft Fabric API nedir?

GraphQL, GraphQL Foundation tarafından tutulan API'ler için açık kaynak sorgu dili ve çalışma zamanıdır. Geleneksel REST API'lerinden farklı olarak GraphQL, istemcilerin tek bir sorguda tam olarak ihtiyaç duydukları verileri istemesine olanak sağlayarak verilerin aşırı getirilip az getirilmesini azaltır.

GraphQL için Microsoft Fabric API,bu güçlü standardı Doku ekosistemine, birden çok veri kaynağını hızlı ve verimli bir şekilde sorgulamanızı sağlayan bir veri erişim katmanı olarak getirir. API, arka uç veri kaynaklarının özelliklerini soyutlar, böylece uygulamanızın mantığına odaklanır ve bir istemcinin ihtiyaç duyduğu tüm verileri tek bir çağrıda sağlarsınız. Basit sorgu dili ve verimli sonuç kümesi işlemesi sayesinde GraphQL, uygulamaların Doku'daki verilerinize erişme süresini en aza indirir.

Fabric verileri için neden GraphQL kullanılır?

GraphQL olmadan, Doku verilerinin uygulamalara açıklanması genellikle şu yaklaşımlardan birini gerektirir:

Doğrudan veritabanı bağlantıları

  • Uygulamalar SQL sürücülerini (ODBC, JDBC) kullanarak doğrudan lakehouse'lara veya ambarlara bağlanır
  • Uygulama kodunu veritabanı şemalarıyla sıkı bir şekilde eşler; şema değişiklikleri uygulamaları böler
  • Her uygulamada bağlantı dizelerini, kimlik bilgilerini ve sürücü bağımlılıklarını yönetmeyi gerektirir
  • Uygulama koduna eklenmiş SQL sorgularını test etmek ve korumak zordur

Özel REST API'leri

  • ASP.NET veya Node.js gibi çerçevelerle özel arka uç hizmetleri oluşturma ve bakımını yapma
  • Her uç nokta için denetleyici kodu, yönlendirme mantığı ve veri erişim katmanları yazma
  • Veri yapıları değiştiğinde ayrı API sürümleri (v1, v2, v3) oluşturma
  • Fazla veri getirme (birkaç sütuna ihtiyacınız olduğunda satırların tamamını alma) veya az getirme (ilgili veriler için birden çok gidiş dönüş yapma)

GraphQL şu zorlukları çözer:

  • Arka uç kodu gerekmez: Doku, veri kaynaklarınızdan GraphQL şemasını, çözümleyicileri ve uç noktayı otomatik olarak oluşturur
  • Tam olarak ihtiyacınız olanı sorgula: Tek bir sorguda belirli alanlar isteme, aşırı getirme ve yük boyutlarını azaltmayı ortadan kaldırır
  • Tek bir istekte ilgili verileri getirme: birden çok gidiş dönüş olmadan ilişkileri dolaşma (N+1 sorgu sorunu yok)
  • Değişiklikleri bozmadan şema evrimi: Mevcut sorguları etkilemeden yeni alanlar ekleyin; istemciler yalnızca bildiklerini istemektedir
  • Tür güvenliği ve belgeleme: Geliştirme araçlarının anlayabildiği entegre iç gözlemle kendi kendini belgeleyen şema
  • Birden çok kaynağa birleşik erişim: Tek bir uç nokta üzerinden göl evleri, ambarlar ve SQL veritabanları arasında sorgulama

Uygulama geliştiricileri için GraphQL, daha az altyapıyla daha hızlı geliştirme anlamına gelir. Veri mühendisleri için bu, özel API kodu yazmadan ve bakımını yapmadan verileri ortaya çıkarmak anlamına gelir.

GraphQL için API'yi kimler kullanmalıdır?

GraphQL için Fabric'in API'si şu amaçlarla tasarlanmıştır:

  • Veri odaklı web ve Fabric lakehouse ve ambar verilerini kullanan mobil uygulamalar oluşturan uygulama geliştiricileri
  • Veri mühendisleri, Fabric verilerini özel arka uç kodu yazmadan modern, esnek API'ler aracılığıyla aşağı akış uygulamalarına sunmakta
  • Özel uygulamalara ve otomatik iş akışlarına Fabric verilerini bağlayan entegrasyon geliştiricileri
  • Power BI'i Doku verileriyle tamamlayan özel analiz uygulamaları oluşturan BI geliştiricileri
  • Programlı API'ler aracılığıyla Doku verilerini ve makine öğrenmesi içgörülerini ortaya atan veri bilimciler

Microsoft Fabric birleşik analiz platformunda çalışıyorsanız ve lakehouse, ambar veya SQL veritabanı verilerini uygulamalar için erişilebilir hale getirmeniz gerekiyorsa GraphQL API'si tam olarak ihtiyacınız olan verileri sorgulamak için verimli ve geliştirici dostu bir yol sağlar.

Tavsiye

Fabric GraphQL API'lerini yapay zeka aracılarıyla tümleştirmek mi istiyorsunuz? Model Bağlam Protokolü'nü kullanarak yapay zeka ajanlarınızı Doku verilerinize bağlamak için Yerel GraphQL MCP sunucusu oluşturma öğreticisini deneyin.

GraphQL için API aracılığıyla verileri kullanıma sunma

Veri kaynaklarını Microsoft Fabric'te bir GraphQL öğesine ifşa etmek basittir ve Doku portalının görsel arabirimi kullanılarak dakikalar içinde gerçekleştirilebilir. İşlem şunları içerir:

  1. Fabric çalışma alanınızda GraphQL API öğesi oluşturun
  2. Kullanılabilir veri gölcükleri, ambarlar veya veritabanları arasından seçim yaparak veri kaynaklarınızı bağlama
  3. Tablolar, görünümler veya saklı yordamlar gibi hangi nesnelerin kullanıma sunuleceğini seçme
  4. Güçlü iç içe sorguları etkinleştirmek için nesneler arasındaki ilişkileri tanımlama (isteğe bağlı)
  5. API'nize kimlerin erişebileceğini denetlemek için izinleri yapılandırma

Yapılandırıldıktan sonra Doku otomatik olarak GraphQL şemasını oluşturur, gerekli çözümleyicileri oluşturur ve size bir uç nokta URL'si sağlar. API'niz hemen sorguları kabul etmeye hazırdır; dağıtım veya altyapı kurulumu gerekmez.

Adım adım yönergeler için bkz. Dokuda GraphQL için API oluşturma ve veri ekleme.

Desteklenen veri kaynakları

Şu anda aşağıdaki desteklenen veri kaynakları GraphQL için Doku API'sinde kullanıma sunulmaktadır:

  • Microsoft Fabric Veri Ambarı
  • Microsoft Fabric SQL veritabanı
  • SQL Analytics Uç Noktası Üzerinden Microsoft Fabric Lakehouse
  • SQL Analytics Uç Noktası aracılığıyla Microsoft Fabric Yansıtılmış Veritabanları, örneğin:
    • Azure SQL Veritabanı
    • Azure SQL Yönetilen Varlık
    • Azure Cosmos DB veritabanı
    • Microsoft Fabric SQL Veritabanı
    • Azure Databricks
    • Snowflake
    • Yansıtılmış veritabanlarını açma
  • Azure SQL veritabanı
  • Datamart

Özellikler

GraphQL için Microsoft Fabric API,uygulamalar için veri erişimini kolaylaştıran kapsamlı özellikler sağlar. Otomatik kod oluşturmadan performans izlemeye kadar bu özellikler en az yapılandırmayla güçlü veri API'leri oluşturmanıza olanak tanır.

Otomatik şema oluşturma

  • Şema bulma: Veri kaynağı şemalarını otomatik olarak bulur ve GraphQL türleriyle eşler
  • Sorgu ve mutasyon oluşturma: Veri yapınıza göre GraphQL sorguları ve mutasyonları oluşturur
  • Çözümleyici oluşturma: Kaynaklarınızdan veri getirmek için gereken çözümleyicileri otomatik olarak oluşturur
  • Yerel test kodu: Anında test ve geliştirme için örnek kod oluşturur

Veri kaynağı esnekliği

  • Birden çok veri kaynağı: Çok yönlü sorgu desteğiyle birden çok veri kaynağı arasında bağlanma ve sorgulama
  • Veritabanı nesneleri: SQL veritabanlarında ve ambarlarında tablolar, görünümler ve saklı yordamlar için tam destek
  • Seçmeli pozlama: API aracılığıyla kullanıma açık olacak belirli nesneleri ve sütunları seçme
  • İlişki modelleme: Veri varlıkları arasında bire bir, bire çok ve çoka çok ilişkileri oluşturma

Operasyonlar ve izleme

  • Performans izleme: API davranışını ve kullanımını izlemek için yerleşik pano ve istek günlüğü

Sürüm oluşturma olmadan şema evrimi

GraphQL, geleneksel sürüm oluşturmadan kaçınarak API evrimine benzersiz bir yaklaşım benimser. GraphQL API'leri v1, v2 ve v3 uç noktaları oluşturmak yerine sürekli olarak gelişir:

  • Eklemeli değişiklikler: Mevcut sorguları bozmadan yeni türler, alanlar ve özellikler ekleyebilirsiniz. İstemciler yalnızca ihtiyaç duydukları alanları istediğinden, yeni alanlar bunları etkilemez.
  • Geriye dönük uyumluluk: GraphQL yalnızca açıkça istenen verileri döndürdüğünden, şema büyüdükçe bile mevcut sorgular çalışmaya devam eder.
  • Kaldırmak yerine kullanım dışı bırakma: Alanlar hemen kaldırılmak yerine kullanım dışı olarak işaretlenebilir ve istemcilerin uyum sağlaması için zaman tanır.
  • Tek uç nokta: Uygulamalar, şema değişiklikleri ne olursa olsun her zaman aynı uç noktaya bağlanır.

Bu yaklaşım, geleneksel sürüme alınan API'lere kıyasla API bakımını ve istemci yükseltmelerini basitleştirir. Doku'da GraphQL API şemanızı değiştirdiğinizde, mevcut alanları kaldırmak veya yeniden adlandırmak yerine yeni özellikler eklediğiniz sürece mevcut uygulamalar çalışmaya devam eder. Şema değişikliklerini yönetme hakkında daha fazla bilgi için bkz. GraphQL için Fabric API introspection ve şema dışa aktarma.

Etkileşimli düzenleme deneyimi

GraphQL api'sinde sorgularınızı ve mutasyonlarınızı kolayca geliştirip test etmenizi sağlayan bir düzenleyici bulunur. Düzenleyicinin özellikleri şunlardır:

  • Sorguların ve mutasyonların çıkışını görselleştirmek için bir sonuç bölmesi
  • Sorgu ve mutasyon parametreleri desteği
  • GraphQL söz dizimlerini ve şema nesnesi adlarını destekleyen IntelliSense

GraphQL düzenleyicisini kullanma hakkında daha fazla bilgi için bkz. GraphQL düzenleyicisi için API.

Sınırlama

Daha fazla bilgi için GraphQL sınırlamaları için API'ye bakın.

İlgili içerik

  • Last updated on