Fabric Data Warehouse MCP sunucusu (Önizleme)

Şunlar için geçerlidir:✅ Microsoft Fabric'te SQL analiz uç noktası ve Ambarı

Uzak Fabric Data Warehouse MCP sunucusu, yapay zeka aracılarının doğal dil kullanarak bir ambarla çalışmasını sağlayan barındırılan bir MCP uç noktasıdır. Model Bağlam Protokolü'ne (MCP) dayanan bu yapı, aracılara executeSQL aracı üzerinden T-SQL ifadelerini çalıştırmaları, sonuçları incelemeleri ve Fabric izinleri ile güvenlik sınırlarını gözetirken gerçek ambar bağlamında yinelenen işlemler gerçekleştirmeleri için yönetilen bir yol sunar.

Bu makalede şunların nasıl yapıldığını görebilirsiniz:

• Visual Studio Code'da uzak Fabric Data Warehouse MCP sunucusuna bağlanma

• Genel uç noktayı veya öğe kapsamındaki uç noktayı yapılandırın

• Fabric Data Warehouse karşı T-SQL oluşturmak ve çalıştırmak için GitHub Copilot kullanma

• Test sorguları ile bağlantıyı doğrulama

Prerequisites

Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

• Visual Studio Code: Visual Studio Code'nin en son sürümünü yükleyin.

  • Visual Studio Code'u İndir

• GitHub Copilot: Visual Studio Code'da GitHub Copilot ve GitHub Copilot Sohbet'i yükleyin ve oturum açın.

  • GitHub Copilot uzantısı
  • GitHub Copilot Sohbet uzantısı

• Fabric Data Warehouse erişimi: En az bir Fabric Data Warehouse veya SQL analiz uç noktasına erişmeniz gerekir.

• Warehouse izinleri: Aracıdan çalıştırmasını istediğiniz T-SQL ifadelerini çalıştırmak için gerekli Fabric çalışma alanı ve SQL izinlerine ihtiyacınız var.

• Depo bağlamı: Öğe kapsamındaki uç noktayı kullanmayı planlıyorsanız, çalışma alanı kimliğini ve depo öğesi kimliğini hazır bulundurun.

Uç nokta seçme

Fabric Data Warehouse MCP sunucusu, kullanım örneğine bağlı olarak iki uç nokta seçeneği sunar. İstemler üzerinden esnek depo seçimi için genel uç noktayı ya da bağlantıyı belirli bir depoya bağlamak için öğe düzeyindeki uç noktayı seçin.

Genel uç nokta

Fabric Data Warehouse MCP sunucusuna bağlanmak istediğinizde, genel uç noktayı kullanarak istemler veya araç argümanları aracılığıyla veri ambarı bağlamı sağlayın:

https://api.fabric.microsoft.com/v1/mcp/dataPlane/sqlEndpoint

Öğe kapsamındaki uç nokta

MCP sunucu bağlantısının belirli bir Fabric Data Warehouse öğesine bağlı olmasını istediğinizde öğe kapsamındaki uç noktayı kullanın.

https://api.fabric.microsoft.com/v1/mcp/dataPlane/workspaces/<workspace-id>/items/<item-id>/sqlEndpoint

Replace:

• <workspace-id> Fabric çalışma alanı kimliği ile.

• <item-id>Fabric Data Warehouse öğe kimliğiyle birlikte.

Öğe kapsamındaki uç nokta, aracı deneyimini belirli bir ambara sabitlemek ve sohbet sırasında ambar bağlamını tekrar tekrar belirtmekten kaçınmak istediğinizde kullanışlıdır.

Visual Studio Code'da ayarlama

sunucu yapılandırmasını MCP ayarları dosyanıza ekleyerek Visual Studio Code'da Fabric Data Warehouse MCP sunucusunu yapılandırın. Esnek ambar seçimi için genel uç nokta ile bağlantıyı belirli bir ambara bağlamak için öğe kapsamındaki uç nokta arasında seçim yapın.

1. Seçenek: Genel uç noktayı yapılandırma

Visual Studio Code MCP yapılandırma dosyanıza aşağıdaki sunucu yapılandırmasını ekleyin:

{
   "servers": {
      "fabric-dw-global": {
         "type": "http",
         "url": "https://api.fabric.microsoft.com/v1/mcp/dataPlane/sqlEndpoint"
      }
   }
}

Yapılandırmayı kaydettikten sonra, Visual Studio Code'da MCP sunucularını yeniden başlatın veya yenileyin.

Seçenek 2: Öğe düzeyindeki uç noktayı yapılandırın

Visual Studio Code MCP yapılandırma dosyanıza aşağıdaki sunucu yapılandırmasını ekleyin:

{
   "servers": {
      "fabric-dw-item": {
         "type": "http",
         "url": "https://api.fabric.microsoft.com/v1/mcp/dataPlane/workspaces/<workspace-id>/items/<item-id>/sqlEndpoint"
      }
   }
}

<workspace-id> ve <item-id> değerlerini deponuza ait değerlerle değiştirin.

Yapılandırmayı kaydettikten sonra, Visual Studio Code'da MCP sunucularını yeniden başlatın veya yenileyin.

Bağlantınızı test edin

Bağlantıyı yapılandırdıktan sonra kurulumun çalıştığını doğrulayın.

1. Visual Studio Code'da MCP sunucusunu başlatın.

   • MCP sunucuları panelini açın.

   • Fabric Data Warehouse MCP sunucusunun bağlı olarak göründüğünü onaylayın.

2. GitHub Copilot Chat'i açın.

   • Visual Studio Code'de Copilot Chat başlatın.

   • Aracı modunu etkinleştirin.

3. Genel uç noktayı kullanıyorsanız depo bağlamını belirtin.

   • Genel uç noktayı yapılandırdıysanız Copilot aşağıdaki gibi bir istemle hangi ambarı kullanacağınızı bildirin:

     Use the Fabric Data Warehouse named SalesDW in the Sales Analytics workspace.
     

   • Öğe kapsamındaki uç noktayı yapılandırdıysanız, sunucu uç nokta URL’sinde zaten depo öğesiyle sınırlandırılmıştır.

4. Bir soru sorun.

   • Örnek:

   What tables and views are in this warehouse?
   

   • Örnek:

   Show me the top 10 products by sales revenue.
   

5. Araç kullanımını yetkilendirme.

   • İstendiğinde, executeSQL araç çağrısını gözden geçirin ve onaylayın.

   • İstenirse Microsoft kimlik bilgilerinizle kimlik doğrulaması.

6. Yanıtı gözden geçirin.

   • Copilot onaylanan T-SQL deyimini yürütmek için Fabric Data Warehouse MCP sunucusunu kullanır ve sonucu sohbette döndürür.

Kullanılabilir araçlar

Fabric Data Warehouse MCP sunucusu bir aracı kullanıma sunar.

Tool	Description
executeSQL	Fabric Data Warehouse için onaylı bir T-SQL deyimi yürütür ve sonucu döndürür.

Sunucu şemaları listelemek, tabloları tanımlamak, sorgu geçmişini almak veya ambar meta verilerini incelemek için ayrı araçlar sunmaz. Aracıdan, executeSQL aracılığıyla T-SQL oluşturup çalıştırmasını isteyerek bu iş akışlarını yine tamamlayabilirsiniz.

Örneğin, aracı ayrı bir tablo keşif aracını çağırmak yerine, INFORMATION_SCHEMA.TABLES veya desteklenen diğer sistem görünümlerine karşı bir sorguyla executeSQL kullanabilir.

Örnek istemlerle doğrulayın

Sunucunun T-SQL oluşturabildiğini, T-SQL çalıştırabildiğini ve sonuçları açıkladığını onaylamak için bu istemleri kullanın.

Ambar nesnelerini keşfetme

• Bu ambardaki tüm şemaları listeleyin.

• Şemaya göre gruplandırılmış tüm tabloları ve görünümleri listeleyin.

• dbo.Customers tablosu için sütunları, veri türlerini ve null değer alabilirliğini gösterin.

T-SQL oluşturma ve çalıştırma

• Gelire göre ilk 10 ürünü döndüren bir T-SQL sorgusu yazın ve çalıştırın.

• Tablodaki Orders satırları sipariş durumuna göre sayan bir sorgu çalıştırın.

• Bölgeye göre geliri göstermek için , Orders, Customersve Products değerlerini birleştiren Regionsbir sorgu oluşturun.

Sorguları anlama ve geliştirme

• Bu T-SQL sorgusunu çalıştırmadan önce ne yaptığını açıklayın.

• Sonucu değiştirmeden okumayı kolaylaştırmak için bu sorguyu yeniden yazın.

• Bu sorgu düzeninde iyileştirmeler önerin, ardından düzeltilen T-SQL'i gösterin.

Ambar etkinliğini izleme

• Bu ambar için son sorgu etkinliğini göster.

• Uzun süre çalışan ve dikkat gerektiren sorgular veya oturumlar bulun.

• Son sorgu hatalarını özetleyin ve olası kök nedene göre gruplandırın.

Note

Tam izleme sorguları, ambar ortamında kullanılabilen sistem görünümlerine bağlıdır.

Güvenlik ve izinler

Fabric Data Warehouse MCP sunucusu oturum açmış kullanıcının kimliğini kullanır ve Fabric izinlerine saygı gösterir. Kullanıcılar, Fabric Data Warehouse içinde yalnızca kimliklerinin yürütme iznine sahip olduğu SQL deyimlerini çalıştırabilir.

executeSQL olan araç çağrıları, MCP istemcisinde açık kullanıcı onayı gerektirmelidir. Özellikle CREATE, ALTER, DROP, INSERT, UPDATE veya DELETE gibi yazma işlemlerinde, executeSQL çalıştırılmasına izin vermeden önce oluşturulan T-SQL'i gözden geçirin.

Üretim ambarları için en az ayrıcalıklı erişimi kullanın.

Ambar nesnelerini değiştiren iş akışlarını etkinleştirmeden önce salt okunur sorgular ve meta veri keşfiyle başlayın.

Troubleshoot

Fabric Data Warehouse MCP sunucusunu ayarlarken veya kullanırken sorun yaşıyorsanız, yaygın sorunları gidermek için aşağıdaki senaryoları kullanın.

MCP sunucusu bağlı olarak gösterilmiyor

MCP yapılandırmasının doğru kaydedildiğini, uç nokta URL'sinin doğru olduğunu ve değişiklik yaptıktan sonra Visual Studio Code'de MCP sunucularını yeniden başlatıp yenilediğinizden emin olun.

Copilot depoyu bulamıyor

Genel uç noktayı kullanıyorsanız sohbette ambar bağlamını sağlayın. Öğe kapsamındaki uç noktayı kullanıyorsanız, çalışma alanı kimliğinin ve öğe kimliğinin doğru olduğunu doğrulayın.

Kimlik doğrulaması başarısız oluyor

Microsoft hesabı ile yeniden oturum açın. Doğru kiracıyı ve dizini kullandığınızdan emin olun.

Araç çağrıları izin hatalarıyla başarısız olur

Gerekli Fabric çalışma alanı rolüne, öğe izinlerine ve SQL izinlerine sahip olduğunuzu onaylayın. Sunucu, Fabric güvenliğini atlatmaz.

Ajan şemaları veya tabloları listeleyemez

Sunucu yalnızca executeSQL öğesini sunar. Aracıdan ayrı şema bulma araçları beklemek yerine SQL meta veri sorgularını kullanmasını isteyin.

Örnek:

Use executeSQL with INFORMATION_SCHEMA views to list the tables in this warehouse.

Sorgu sonuçları beklenmiyor

Copilot'tan, çalıştırmadan önce oluşturulan T-SQL'i göstermesini isteyin. Araç çağrısını onaylamadan önce tablo adlarını, birleşimleri, filtreleri, tarih mantığını ve toplama mantığını gözden geçirin.

İlgili içerik

• Visual Studio Code'da MCP sunucuları