Fabric data warehouse MCP-server (Forhåndsvisning)

Gælder for:✅ SQL Analytics-slutpunkt og warehouse i Microsoft Fabric

Den fjernbeskyttede Fabric data warehouse MCP-server er et hostet MCP-endpoint, der gør det muligt for AI-agenter at arbejde med et lager ved hjælp af naturligt sprog. Bygget på Model Context Protocol (MCP) giver det agenter en styret måde at køre T-SQL-statements gennem værktøjetexecuteSQL, inspicere resultater og iterere mod reel warehouse-kontekst, samtidig med at Fabric-tilladelser og sikkerhedsgrænser respekteres.

I denne artikel lærer du, hvordan du kan:

  • Forbind til den eksterne Fabric data warehouse MCP-server i Visual Studio Code

  • Konfigurér enten det globale endpoint eller et item-scoped endpoint

  • Brug GitHub Copilot til at generere og køre T-SQL mod Fabric data warehouse

  • Valider forbindelsen med testforespørgsler

Forudsætninger

Før du begynder, skal du sikre dig, at du har:

  • Visual Studio Code: Installer den nyeste version af Visual Studio Code.

  • GitHub Copilot: Installer og log ind på GitHub Copilot og GitHub Copilot Chat i Visual Studio Code.

  • Fabric data warehouse adgang: Du skal have adgang til mindst ét Fabric data warehouse- eller SQL-analyse-endpoint.

  • Warehouse-tilladelser: Du skal bruge de nødvendige Fabric-arbejdsområder og SQL-tilladelser for at køre de T-SQL-sætninger, du beder agenten om at udføre.

  • Lagerkontekst: Hav arbejdsområde-ID og lagervare-ID tilgængeligt, hvis du planlægger at bruge item-scoped endpoint.

Vælg et endepunkt

Fabric data warehouse MCP-serveren tilbyder to endpoint-muligheder afhængigt af dit brugsscenarie. Vælg det globale endpoint for fleksibel lagerudvælgelse via prompts, eller item-scoped endpoint for at binde forbindelsen til et specifikt lager.

Globalt endepunkt

Når du vil forbinde til Fabric data warehouse MCP-serveren, skal du give lagerkontekst via prompts eller værktøjsargumenter ved at bruge det globale endpoint:

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

Item-scoped endpoint

Brug det item-scopede endpoint, når du vil have MCP-serverforbindelsen til at være bundet til et specifikt Fabric data warehouse item.

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

Erstatte:

  • <workspace-id>med Fabric workspace ID.

  • <item-id>med det Fabric data warehouse vare-ID.

Item-scoped endpoint er nyttigt, når du ønsker, at agentoplevelsen skal være forankret til et specifikt lager og undgå gentagne gange at levere lagerkontekst i chatten.

Opsætning i Visual Studio Code

Konfigurer Fabric data warehouse MCP-serveren i Visual Studio Code ved at tilføje serverkonfigurationen til din MCP-indstillingsfil. Vælg mellem det globale endpoint for fleksibel lagervalg eller item-scoped endpoint for at binde forbindelsen til et specifikt lager.

Mulighed 1: Konfigurer det globale endepunkt

Tilføj følgende serverkonfiguration til din Visual Studio Code MCP-konfigurationsfil:

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

Efter at have gemt konfigurationen, genstart eller opdater MCP-servere i Visual Studio Code.

Mulighed 2: Konfigurer det item-scopede endpoint

Tilføj følgende serverkonfiguration til 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"
      }
   }
}

Erstat the <workspace-id> and the <item-id> med værdierne for dit lager.

Efter at have gemt konfigurationen, genstart eller opdater MCP-servere i Visual Studio Code.

Test din forbindelse

Når du har konfigureret forbindelsen, skal du tjekke, at opsætningen virker.

  1. Start MCP-serveren i Visual Studio Code.

    • Åbn MCP-serverpanelet.

    • Bekræft, at Fabric data warehouse MCP-serveren vises som tilsluttet.

  2. Åbn GitHub Copilot Chat.

    • Start Copilot Chat i Visual Studio Code.

    • Aktiver agenttilstand.

  3. Giv lagerkontekst, hvis du bruger det globale endpoint.

    • Hvis du har konfigureret det globale endpoint, så fortæl Copilot, hvilket lager der skal bruges, med en prompt som:

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

    • Hvis du har konfigureret det item-scopede endpoint, er serveren allerede scoped til warehouse-varen i endpoint-URL'en.

  4. Stil et spørgsmål.

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

  5. Godkend brugen af værktøjet.

    • Når du bliver bedt om det, gennemgå og godkend værktøjskaldet executeSQL .

    • Autentificér med dine Microsoft-oplysninger, hvis det bliver bedt om det.

  6. Gennemse svaret.

    • Copilot bruger Fabric data warehouse MCP-serveren til at udføre den godkendte T-SQL-sætning og returnerer resultatet i chatten.

Tilgængelige værktøjer

Den Fabric data warehouse MCP-server eksponerer ét værktøj.

Værktøj Beskrivelse
executeSQL Udfører en godkendt T-SQL-sætning mod Fabric data warehouse og returnerer resultatet.

Serveren eksponerer ikke separate værktøjer til at liste skemaer, beskrive tabeller, hente forespørgselshistorik eller inspicere warehouse-metadata. Du kan stadig gennemføre disse arbejdsgange ved at bede agenten om at generere og køre T-SQL gennem executeSQL.

For eksempel kan agenten i stedet for at kalde et separat tabelopdagelsesværktøj bruge executeSQL det med en forespørgsel mod INFORMATION_SCHEMA.TABLES eller andre understøttede systemvisninger.

Valider med eksempelprompts

Brug disse prompts til at bekræfte, at serveren kan generere T-SQL, udføre T-SQL og forklare resultaterne.

Udforsk lagerobjekter

  • Lav en liste over alle skemaer i dette lager.

  • List alle tabeller og visninger grupperet efter skema.

  • Vis kolonner, datatyper og nullbarhed for tabellen dbo.Customers .

Generer og kør T-SQL

  • Skriv og kør en T-SQL-forespørgsel, der returnerer de 10 bedste produkter efter omsætning.

  • Kør en forespørgsel, der tæller rækker efter ordensstatus i tabellen Orders .

  • Opret en forespørgsel, der samler Orders, Customers, Products, og Regions for at vise indtægter efter region.

Forstå og forbedre forespørgsler

  • Forklar, hvad denne T-SQL-forespørgsel gør, før du kører den.

  • Omskriv denne forespørgsel for at gøre den lettere at læse uden at ændre resultatet.

  • Foreslå forbedringer til dette forespørgselsmønster, og vis derefter den reviderede T-SQL.

Overvåg lageraktivitet

  • Vis nylig forespørgselsaktivitet for dette lager.

  • Find langvarige forespørgsler eller sessioner, der måske kræver opmærksomhed.

  • Opsummer nylige forespørgselsfejl og gruppere dem efter sandsynlig rodårsag.

Bemærkning

De præcise overvågningsforespørgsler afhænger af de systemvisninger, der er tilgængelige i lagermiljøet.

Sikkerhed og tilladelser

Den Fabric data warehouse MCP-server bruger den indloggede brugers identitet og respekterer Fabric tilladelser. Brugere kan kun køre SQL-sætninger, som deres identitet må udføre i Fabric data warehouse.

Værktøjskald, der executeSQL bør kræve eksplicit brugergodkendelse i MCP-klienten. Gennemgå genereret T-SQL, før du lader executeSQL det køre, især for skriveoperationer som CREATE, ALTER, DROP, INSERT, , UPDATE, eller DELETE.

Brug adgang med mindst privilegier til produktionslagre.

Start med skrivebeskyttede forespørgsler og metadata-udforskning, før du aktiverer workflows, der ændrer warehouse-objekter.

Fejlfinding

Hvis du har problemer med at sætte op eller bruge Fabric data warehouse MCP-serveren, kan du bruge følgende scenarier til at fejlfinde almindelige problemer.

MCP-serveren vises ikke som tilsluttet

Bekræft, at MCP-konfigurationen er gemt korrekt, at endpoint-URL'en er korrekt, og at du genstartede eller opdaterede MCP-servere i Visual Studio Code efter at have foretaget ændringer.

Copilot kan ikke finde lageret

Hvis du bruger det globale endpoint, så giv lagerkonteksten i chatten. Hvis du bruger item-scoped endpoint, så bekræft, at arbejdsområde-ID og item id er korrekte.

Autentificering fejler

Log ind igen med din Microsoft-konto. Sørg for, at du bruger den korrekte lejer og mappe.

Værktøjskald fejler med tilladelsesfejl

Bekræft, at du har den nødvendige Fabric-arbejdsområderolle, item-tilladelser og SQL-rettigheder. Serveren omgår ikke Fabric-sikkerheden.

Agenten kan ikke liste skemaer eller tabeller

Serveren eksponerer executeSQLkun . Bed agenten om at bruge SQL-metadataforespørgsler i stedet for at forvente separate værktøjer til skemaopdagelse.

Eksempel: 

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

Forespørgselsresultater er uventede

Spørg Copilot om at vise den genererede T-SQL før eksekvering. Gennemgå tabelnavne, joins, filtre, datologik og aggregeringslogik, før du godkender værktøjskaldet.

Relateret indhold

  • Last updated on