Fabric Data Warehouse MCP-server (förhandsversion)

Gäller för:✅ SQL-analysslutpunkt och lager i Microsoft Fabric

Den fjärranslutna Fabric Data Warehouse MCP-servern är en värdbaserad MCP-slutpunkt som gör det möjligt för AI-agenter att arbeta med ett lager med naturligt språk. Det bygger på MCP (Model Context Protocol) och ger agenter ett styrt sätt att köra T-SQL-instruktioner via executeSQL verktyget, inspektera resultat och iterera mot verklig lagerkontext samtidigt som Fabric behörigheter och säkerhetsgränser respekteras.

Den här artikeln visar hur du gör följande:

  • Anslut till fjärrservern Fabric Data Warehouse MCP i Visual Studio Code

  • Konfigurera antingen den globala slutpunkten eller en slutpunkt med objektomfattning

  • Använd GitHub Copilot för att generera och köra T-SQL mot Fabric Data Warehouse

  • Verifiera anslutningen med testfrågor

Prerequisites

Kontrollera att du har följande innan du börjar:

  • Visual Studio Code: Installera den senaste versionen av Visual Studio Code.

  • GitHub Copilot: Installera och logga in på GitHub Copilot och GitHub Copilot Chatta i Visual Studio Code.

  • Fabric Data Warehouse åtkomst: Du behöver åtkomst till minst en Fabric Data Warehouse- eller SQL-analysslutpunkt.

  • Informationslagerbehörigheter: Du behöver de nödvändiga Fabric-arbetsytan och SQL-behörigheterna för att köra de T-SQL-instruktioner som du ber agenten att köra.

  • Lagerkontext: Ha arbetsytans ID och lagerartikelns ID tillgängliga om du planerar att använda slutpunkten på artikelnivå.

Välj en slutpunkt

Den Fabric Data Warehouse MCP-servern erbjuder två slutpunktsalternativ beroende på ditt användningsfall. Välj den globala ändpunkten för flexibelt val av lager via uppmaningar, eller ändpunkten på artikelnivå för att koppla anslutningen till ett visst lager.

Global slutpunkt

När du vill ansluta till den Fabric Data Warehouse MCP-servern anger du informationslagerkontext via prompter eller verktygsargument med hjälp av den globala slutpunkten:

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

Slutpunkt för objektomfattning

Använd den objektbegränsade slutpunkten när du vill att MCP-serveranslutningen ska vara bunden till ett specifikt Fabric Data Warehouse-objekt.

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

Replace:

  • <workspace-id> med Fabric workspace-ID.

  • <item-id> med objekt-ID:t för Fabric Data Warehouse.

Den objektspecifika slutpunkten är användbar när du vill att agentens upplevelse ska knytas till ett visst lager och slippa ange lagerkontext upprepade gånger i chatten.

Konfigurera i Visual Studio Code

Konfigurera Fabric Data Warehouse MCP-servern i Visual Studio Code genom att lägga till serverkonfigurationen i mcp-inställningsfilen. Välj mellan den globala slutpunkten för val av flexibelt lager eller den objektomfångade slutpunkten för att binda anslutningen till ett specifikt lager.

Alternativ 1: Konfigurera den globala slutpunkten

Lägg till följande serverkonfiguration i din Visual Studio Code MCP-konfigurationsfil:

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

När du har sparat konfigurationen startar du om eller uppdaterar MCP-servrar i Visual Studio Code.

Alternativ 2: Konfigurera slutpunkten med objektomfattning

Lägg till följande serverkonfiguration i din Visual Studio Code MCP-konfigurationsfil:

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

Ersätt <workspace-id> och <item-id> med värdena för ditt lager.

När du har sparat konfigurationen startar du om eller uppdaterar MCP-servrar i Visual Studio Code.

Testa anslutningen

När du har konfigurerat anslutningen kontrollerar du att installationen fungerar.

  1. Starta MCP-servern i Visual Studio Code.

    • Öppna panelen MCP-servrar.

    • Bekräfta att den Fabric Data Warehouse MCP-servern visas som ansluten.

  2. Öppna GitHub Copilot Chat.

    • Starta Copilot Chat i Visual Studio Code.

    • Aktivera agentläge.

  3. Ange informationslagerkontext om du använder den globala slutpunkten.

    • Om du har konfigurerat den globala slutpunkten anger du för Copilot vilket lager som ska användas med en uppmaning som:

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

    • Om du har konfigurerat slutpunkten med objektomfattning är servern redan begränsad till lagerartikeln i slutpunkts-URL:en.

  4. Ställ en fråga.

    • Exempel:
    What tables and views are in this warehouse?
    • Exempel:
    Show me the top 10 products by sales revenue.

  5. Auktorisera verktygsanvändning.

    • När du uppmanas till det granskar och godkänner du verktygsanropet executeSQL .

    • Autentisera med dina Microsoft autentiseringsuppgifter om det begärs.

  6. Läs svaret.

    • Copilot använder Fabric Data Warehouse MCP-servern för att köra den godkända T-SQL-instruktionen och returnerar resultatet i chatten.

Tillgängliga verktyg

Fabric Data Warehouse MCP-servern exponerar ett verktyg.

Tool Description
executeSQL Kör en godkänd T-SQL-instruktion mot Fabric Data Warehouse och returnerar resultatet.

Servern exponerar inte separata verktyg för att visa scheman, beskriva tabeller, hämta frågehistorik eller inspektera informationslagermetadata. Du kan fortfarande slutföra dessa arbetsflöden genom att be agenten att generera och köra T-SQL via executeSQL.

I stället för att anropa ett separat tabellidentifieringsverktyg kan agenten till exempel använda executeSQL med en fråga mot INFORMATION_SCHEMA.TABLES eller andra systemvyer som stöds.

Verifiera med exempelfrågor

Använd dessa uppmaningar för att bekräfta att servern kan generera T-SQL, köra T-SQL och förklara resultat.

Utforska lagerobjekt

  • Visa en lista över alla scheman i det här lagret.

  • Visa en lista över alla tabeller och vyer grupperade efter schema.

  • Visa kolumner, datatyper och nullbarhet för dbo.Customers tabellen.

Generera och köra T-SQL

  • Skriv och kör en T-SQL-fråga som returnerar de 10 främsta produkterna efter intäkter.

  • Kör en fråga som räknar rader efter orderstatus i Orders tabellen.

  • Skapa en fråga som ansluter Orders, Customers, Productsoch Regions för att visa intäkter per region.

Förstå och förbättra frågor

  • Förklara vad den här T-SQL-frågan gör innan du kör den.

  • Skriv om den här frågan så att den blir enklare att läsa utan att ändra resultatet.

  • Föreslå förbättringar av det här frågemönstret och visa sedan den reviderade T-SQL.

Övervaka lageraktivitet

  • Visa den senaste frågeaktiviteten för det här lagret.

  • Hitta långvariga frågor eller sessioner som kan behöva åtgärdas.

  • Sammanfatta de senaste frågemisslyckandena och gruppera dem efter sannolik grundorsak.

Note

De exakta övervakningsfrågorna beror på vilka systemvyer som är tillgängliga i lagermiljön.

Säkerhet och behörigheter

Den Fabric Data Warehouse MCP-servern använder den inloggade användarens identitet och respekterar Fabric behörigheter. Användare kan bara köra SQL-instruktioner som deras identitet tillåts köra i Fabric Data Warehouse.

Verktygsanrop som executeSQL kräver uttryckligt användargodkännande i MCP-klienten. Granska genererad T-SQL innan du tillåter att executeSQL körs, särskilt vid skrivåtgärder som CREATE, ALTER, DROP, INSERT, UPDATE eller DELETE.

Använd åtkomst med lägsta behörighet för produktionslager.

Börja med skrivskyddade frågor och metadatautforskning innan du aktiverar arbetsflöden som ändrar lagerobjekt.

Troubleshoot

Om du har problem med att konfigurera eller använda Fabric Data Warehouse MCP-server använder du följande scenarier för att felsöka vanliga problem.

MCP-servern visas inte som ansluten

Bekräfta att MCP-konfigurationen har sparats korrekt, att slutpunkts-URL:en är korrekt och att du har startat om eller uppdaterat MCP-servrar i Visual Studio Code när du har gjort ändringar.

Copilot kan inte hitta lagret

Om du använder den globala slutpunkten anger du lagerkontexten i chatten. Om du använder den objektbegränsade slutpunkten, kontrollerar du att arbetsytans ID och objekt-ID är korrekta.

Autentiseringen misslyckas

Logga in igen med din Microsoft-konto. Kontrollera att du använder rätt klientorganisation och katalog.

Verktygsanrop misslyckas med behörighetsfel

Kontrollera att du har den Fabric arbetsyteroll, objektbehörigheter och SQL-behörigheter som krävs. Servern kringgår inte Fabric säkerhet.

Agenten kan inte lista scheman eller tabeller

Servern visar bara executeSQL. Be agenten att använda SQL-metadatafrågor i stället för att förvänta sig separata verktyg för schemaidentifiering.

Exempel:

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

Frågeresultat är oväntade

Be Copilot att visa den genererade T-SQL-koden innan körning. Granska tabellnamn, kopplingar, filter, datumlogik och aggregeringslogik innan du godkänner verktygsanropet.

Relaterat innehåll

  • Last updated on