Fabric Data Warehouse MCP-server (preview)

Van toepassing op:✅ SQL Analytics-eindpunt en -magazijn in Microsoft Fabric

De externe Fabric Data Warehouse MCP-server is een gehost MCP-eindpunt waarmee AI-agents met een magazijn kunnen werken met natuurlijke taal. Gebouwd op het Model Context Protocol (MCP), biedt het agents een beheerde manier om T-SQL-instructies uit te voeren via het executeSQL hulpprogramma, resultaten te inspecteren en de werkelijke magazijncontext te herhalen met inachtneming van Fabric machtigingen en beveiligingsgrenzen.

In dit artikel leest u hoe u het volgende kunt doen:

  • Verbinding maken met de externe Fabric Data Warehouse MCP-server in Visual Studio Code

  • Het globale eindpunt of een eindpunt met itembereik configureren

  • Gebruik GitHub Copilot om T-SQL te genereren en uit te voeren op Fabric Data Warehouse

  • De verbinding met testquery's valideren

Prerequisites

Voordat u begint, moet u ervoor zorgen dat u het volgende heeft:

  • Visual Studio Code: installeer de nieuwste versie van Visual Studio Code.

  • GitHub Copilot: Installeer en meld u aan bij GitHub Copilot en GitHub Copilot Chat in Visual Studio Code.

  • Fabric Data Warehouse toegang: u hebt toegang nodig tot ten minste één Fabric Data Warehouse of SQL Analytics-eindpunt.

  • Machtigingen voor Warehouse: U hebt de vereiste machtigingen voor de Fabric-werkruimte en voor SQL nodig om de T-SQL-instructies uit te voeren die u de agent vraagt uit te voeren.

  • Magazijncontext: zorg ervoor dat de werkruimte-id en de magazijnitem-id beschikbaar zijn als u het eindpunt binnen het bereik van het item wilt gebruiken.

Een eindpunt kiezen

De Fabric Data Warehouse MCP-server biedt twee eindpuntopties, afhankelijk van uw use-case. Kies het globale eindpunt voor flexibele magazijnselectie op basis van prompts, of het itemgebonden eindpunt om de verbinding te koppelen aan een specifiek magazijn.

Globaal eindpunt

Wanneer u verbinding wilt maken met de Fabric Data Warehouse MCP-server, geeft u magazijncontext op via prompts of hulpprogrammaargumenten met behulp van het globale eindpunt:

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

Eindpunt op itemniveau

Gebruik het eindpunt binnen het bereik van het item wanneer u wilt dat de MCP-serververbinding is gebonden aan een specifiek Fabric Data Warehouse item.

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

Replace:

  • <workspace-id> met de Fabric-werkruimte-id.

  • <item-id> met de item-id van Fabric Data Warehouse.

Het itemspecifieke eindpunt is handig wanneer u wilt dat de agentervaring gekoppeld is aan een specifiek magazijn, zodat u niet steeds opnieuw magazijncontext in de chat hoeft op te geven.

Instellen in Visual Studio Code

Configureer de Fabric Data Warehouse MCP-server in Visual Studio Code door de serverconfiguratie toe te voegen aan uw MCP-instellingenbestand. Kies tussen de globale endpoint voor flexibele selectie van magazijnen of de itemgebonden endpoint om de verbinding aan een specifiek magazijn te koppelen.

Optie 1: Het globale eindpunt configureren

Voeg de volgende serverconfiguratie toe aan uw Visual Studio Code MCP-configuratiebestand:

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

Nadat u de configuratie hebt opgeslagen, start u MCP-servers opnieuw op of vernieuwt u deze in Visual Studio Code.

Optie 2: De itemspecifieke endpoint configureren

Voeg de volgende serverconfiguratie toe aan uw Visual Studio Code MCP-configuratiebestand:

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

Vervang de <workspace-id> en de <item-id> waarden voor uw magazijn.

Nadat u de configuratie hebt opgeslagen, start u MCP-servers opnieuw op of vernieuwt u deze in Visual Studio Code.

Uw verbinding testen

Nadat u de verbinding hebt geconfigureerd, controleert u of de installatie werkt.

  1. Start de MCP-server in Visual Studio Code.

    • Open het paneel MCP-servers.

    • Controleer of de Fabric Data Warehouse MCP-server wordt weergegeven als verbonden.

  2. Open GitHub Copilot Chat.

    • Start Copilot Chat in Visual Studio Code.

    • Schakel de agentmodus in.

  3. Geef magazijncontext op als u het globale eindpunt gebruikt.

    • Als u het globale eindpunt hebt geconfigureerd, geeft u Copilot aan welk magazijn moet worden gebruikt met een prompt zoals:

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

    • Als u het itemspecifieke eindpunt hebt geconfigureerd, is de server in de eindpunt-URL al beperkt tot het magazijnitem.

  4. Stel een vraag.

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

  5. Het gebruik van hulpprogramma's autoriseren.

    • Wanneer u hierom wordt gevraagd, controleert en keurt u de aanroep van het executeSQL hulpprogramma goed.

    • Verifieer met uw Microsoft-referenties, indien aangevraagd.

  6. Bekijk het antwoord.

    • Copilot gebruikt de Fabric Data Warehouse MCP-server om de goedgekeurde T-SQL-instructie uit te voeren en het resultaat in de chat te retourneren.

Beschikbare hulpmiddelen

De Fabric Data Warehouse MCP-server maakt één hulpprogramma beschikbaar.

Tool Description
executeSQL Voert een goedgekeurde T-SQL-instructie uit op Fabric Data Warehouse en retourneert het resultaat.

De server biedt geen afzonderlijke hulpprogramma's voor het weergeven van schema's, het beschrijven van tabellen, het ophalen van querygeschiedenis of het inspecteren van metagegevens van het magazijn. U kunt deze werkstromen nog steeds voltooien door de agent te vragen T-SQL te genereren en uit te voeren via executeSQL.

Bijvoorbeeld, in plaats van een afzonderlijk hulpprogramma aan te roepen om tabellen te detecteren, kan de agent executeSQL gebruiken met een query op INFORMATION_SCHEMA.TABLES of andere ondersteunde systeemweergaven.

Valideren met voorbeeldprompts

Gebruik deze prompts om te bevestigen dat de server T-SQL kan genereren, T-SQL kan uitvoeren en resultaten kan uitleggen.

Magazijnobjecten verkennen

  • Geef alle schema's in dit magazijn weer.

  • Een lijst weergeven van alle tabellen en weergaven gegroepeerd op schema.

  • De kolommen, gegevenstypen en null-waarde voor de dbo.Customers tabel weergeven.

T-SQL genereren en uitvoeren

  • Schrijf en voer een T-SQL-query uit die de tien belangrijkste producten retourneert op basis van omzet.

  • Voer een query uit waarmee rijen worden geteld op volgordestatus in de Orders tabel.

  • Maak een query waarin Orders, Customers, Products en Regions worden samengevoegd om de omzet per regio weer te geven.

Zoekopdrachten begrijpen en verbeteren

  • Leg uit wat deze T-SQL-query doet voordat u deze uitvoert.

  • Herschrijf deze query om het gemakkelijker te lezen zonder het resultaat te wijzigen.

  • Stel verbeteringen voor aan dit querypatroon en geef vervolgens de herziene T-SQL weer.

Magazijnactiviteit bewaken

  • Recente queryactiviteit voor dit magazijn weergeven.

  • Zoek langlopende query’s of sessies die mogelijk aandacht nodig hebben.

  • U kunt recente queryfouten samenvatten en groeperen op basis van waarschijnlijke hoofdoorzaak.

Note

De exacte bewakingsquery's zijn afhankelijk van de systeemweergaven die beschikbaar zijn in de magazijnomgeving.

Beveiliging en machtigingen

De Fabric Data Warehouse MCP-server gebruikt de identiteit van de aangemelde gebruiker en respecteert Fabric machtigingen. Gebruikers kunnen alleen SQL-instructies uitvoeren waarvoor hun identiteit in Fabric Data Warehouse gemachtigd is.

Toolaanroepen die executeSQL vereisen expliciete goedkeuring van de gebruiker in de MCP-client. Controleer de gegenereerde T-SQL voordat u executeSQL toestaat deze uit te voeren, met name voor schrijfbewerkingen zoals CREATE, ALTER, DROP, INSERT, UPDATE of DELETE.

Gebruik toegang met minimale bevoegdheden voor productiewarehouses.

Begin met alleen-leesquery's en het verkennen van metagegevens voordat u workflows inschakelt die datawarehouse-objecten wijzigen.

Troubleshoot

Als u problemen ondervindt met het instellen of gebruiken van de Fabric Data Warehouse MCP-server, gebruikt u de volgende scenario's om veelvoorkomende problemen op te lossen.

De MCP-server wordt niet weergegeven als verbonden

Controleer of de MCP-configuratie correct is opgeslagen, of de eindpunt-URL juist is en of u de MCP-servers opnieuw hebt opgestart of vernieuwd in Visual Studio Code nadat u wijzigingen hebt aangebracht.

Copilot kan het magazijn niet vinden

Als u het globale eindpunt gebruikt, geeft u de magazijncontext op in de chat. Als u het eindpunt met itembereik gebruikt, controleert u of de werkruimte-id en item-id juist zijn.

Verificatie mislukt

Meld u opnieuw aan met uw Microsoft-account. Zorg ervoor dat u de juiste tenant en map gebruikt.

Aanroepen van hulpprogramma's mislukken met machtigingsfouten

Controleer of u over de vereiste Fabric werkruimterol, itemmachtigingen en SQL-machtigingen beschikt. De server omzeilt Fabric beveiliging niet.

De agent kan geen schema's of tabellen weergeven

De server stelt alleen executeSQL beschikbaar. Vraag de agent om SQL-metagegevensquery's te gebruiken in plaats van afzonderlijke hulpprogramma's voor schemadetectie te verwachten.

Voorbeeld:

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

Queryresultaten zijn onverwacht

Vraag het aan Copilot om de gegenereerde T-SQL weer te geven vóór de uitvoering. Bekijk tabelnamen, joins, filters, datumlogica en aggregatielogica voordat u de aanroep van het hulpprogramma goedkeurt.

Verwante inhoud

  • Last updated on