Fabric datalager MCP-server (Forhåndsvisning)

Gjelder for:✅ SQL Analytics-endepunkt og Warehouse i Microsoft Fabric

Den eksterne Fabric datalager MCP-serveren er et hostet MCP-endepunkt som gjør det mulig for AI-agenter å arbeide med et lager ved hjelp av naturlig språk. Bygget på Model Context Protocol (MCP) gir det agenter en styrt måte å kjøre T-SQL-setninger gjennom executeSQL verktøyet, inspisere resultater og iterere mot ekte lagerkontekst samtidig som Fabric-tillatelser og sikkerhetsgrenser respekteres.

Denne artikkelen viser deg hvordan du gjør følgende:

  • Koble til den eksterne Fabric datalager MCP-serveren i Visual Studio Code

  • Konfigurer enten det globale endepunktet eller et item-scoped endepunkt

  • Bruk GitHub Copilot til å generere og kjøre T-SQL mot Fabric datalager

  • Valider forbindelsen med testspørringer

Forutsetninger

Før du begynner, må du sørge for at du har:

  • Visual Studio Code: Installer den nyeste versjonen av Visual Studio Code.

  • GitHub Copilot: Installer og logg inn på GitHub Copilot og GitHub Copilot Chat i Visual Studio Code.

  • Fabric datalager tilgang: Du trenger tilgang til minst ett Fabric datalager- eller SQL-analyseendepunkt.

  • Warehouse-tillatelser: Du trenger nødvendige Fabric-arbeidsområder og SQL-tillatelser for å kjøre T-SQL-setningene du ber agenten om å utføre.

  • Lagerkontekst: Ha arbeidsområde-ID og varevare-ID tilgjengelig hvis du planlegger å bruke item-scoped endepunkt.

Velg et endepunkt

Den Fabric datalager MCP-serveren tilbyr to endepunktalternativer avhengig av bruksområdet ditt. Velg det globale endepunktet for fleksibel lagerutvelgelse gjennom prompts, eller det item-scoped endepunktet for å binde forbindelsen til et spesifikt lager.

Globalt endepunkt

Når du vil koble til den Fabric datalager MCP-serveren, oppgi lagerkontekst gjennom prompts eller verktøyargumenter ved å bruke det globale endepunktet:

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

Element-scoped endepunkt

Bruk det item-scoped endepunktet når du vil at MCP-serverforbindelsen skal være bundet til et spesifikt Fabric datalager element.

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 Fabric datalager vare-ID.

Item-scoped endepunktet er nyttig når du vil at agentopplevelsen skal være forankret til et spesifikt lager og unngå å gjentatte ganger gi lagerkontekst i chatten.

Oppsett i Visual Studio Code

Konfigurer Fabric datalager MCP-serveren i Visual Studio Code ved å legge serverkonfigurasjonen til MCP-innstillingsfilen din. Velg mellom det globale endepunktet for fleksibel lagerutvelgelse eller det vareomfangede endepunktet for å binde forbindelsen til et spesifikt lager.

Alternativ 1: Konfigurer det globale endepunktet

Legg til følgende serverkonfigurasjon i din Visual Studio Code MCP-konfigurasjonsfil:

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

Etter å ha lagret konfigurasjonen, start eller oppdater MCP-servere i Visual Studio Code.

Alternativ 2: Konfigurer det item-scopede endepunktet

Legg til følgende serverkonfigurasjon i din Visual Studio Code MCP-konfigurasjonsfil:

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

Bytt ut the <workspace-id> and the <item-id> med verdiene for lageret ditt.

Etter å ha lagret konfigurasjonen, start eller oppdater MCP-servere i Visual Studio Code.

Test tilkoblingen

Etter at du har konfigurert tilkoblingen, sjekk at oppsettet fungerer.

  1. Start MCP-serveren i Visual Studio Code.

    • Åpne MCP-serverpanelet.

    • Bekreft at Fabric datalager MCP-serveren vises som tilkoblet.

  2. Åpne GitHub Copilot Chat.

    • Start Copilot Chat i Visual Studio Code.

    • Aktiver agentmodus.

  3. Oppgi lagerkontekst hvis du bruker det globale endepunktet.

    • Hvis du har konfigurert det globale endepunktet, fortell Copilot hvilket lager de skal bruke med en prompt som:

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

    • Hvis du har konfigurert det item-scoped endepunktet, er serveren allerede scoped til varelagervaren i endepunktets URL.

  4. Still et spørsmål.

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

  5. Autoriser bruk av verktøy.

    • Når du blir bedt om det, gjennomgå og godkjenn executeSQL verktøykallet.

    • Autentiser deg med dine Microsoft-legitimasjoner hvis du blir bedt om det.

  6. Se gjennom svaret.

    • Copilot bruker Fabric datalager MCP-serveren til å kjøre den godkjente T-SQL-setningen og returnerer resultatet i chatten.

Tilgjengelige verktøy

Fabric datalager MCP-serveren eksponerer ett verktøy.

Verktøy Beskrivelse
executeSQL Utfører en godkjent T-SQL-setning mot Fabric datalager og returnerer resultatet.

Serveren eksponerer ikke separate verktøy for å liste skjemaer, beskrive tabeller, hente spørringshistorikk eller inspisere varelagermetadata. Du kan fortsatt fullføre disse arbeidsflytene ved å be agenten generere og kjøre T-SQL gjennom executeSQL.

For eksempel, i stedet for å kalle et eget tabelloppdagelsesverktøy, kan agenten bruke executeSQL med en spørring mot INFORMATION_SCHEMA.TABLES eller andre støttede systemvisninger.

Valider med eksempelprompter

Bruk disse promptene for å bekrefte at serveren kan generere T-SQL, kjøre T-SQL og forklare resultatene.

Utforsk lagerobjekter

  • List opp alle skjemaer i dette lageret.

  • List opp alle tabeller og visninger gruppert etter skjema.

  • Vis kolonnene, datatypene og nullbarheten for tabellen dbo.Customers .

Generer og kjør T-SQL

  • Skriv og kjør en T-SQL-spørring som returnerer de ti beste produktene etter inntekt.

  • Kjør en spørring som teller rader etter ordrestatus i Orders tabellen.

  • Lag en spørring som slår sammen Orders, Customers, Products, og Regions for å vise inntekt etter region.

Forstå og forbedre spørringer

  • Forklar hva denne T-SQL-spørringen gjør før du kjører den.

  • Skriv om denne forespørselen for å gjøre den lettere å lese uten å endre resultatet.

  • Foreslå forbedringer av dette spørringsmønsteret, og vis deretter den reviderte T-SQL.

Overvåk lageraktivitet

  • Vis nylig forespørselsaktivitet for dette lageret.

  • Finn langvarige spørsmål eller økter som kan trenge oppmerksomhet.

  • Oppsummer nylige spørringsfeil og gruppere dem etter sannsynlig rotårsak.

Note

De nøyaktige overvåkingsforespørslene avhenger av systemvisningene som er tilgjengelige i lagermiljøet.

Sikkerhet og tillatelser

Den Fabric datalager MCP-serveren bruker brukerens innloggede identitet og respekterer Fabric tillatelser. Brukere kan kun kjøre SQL-setninger som identiteten deres har lov til å utføre i Fabric datalager.

Verktøykall som executeSQL skal kreve eksplisitt brukergodkjenning i MCP-klienten. Gjennomgå generert T-SQL før du lar executeSQL den kjøre, spesielt for skriveoperasjoner som CREATE, ALTER, DROP, INSERT, , UPDATE, eller DELETE.

Bruk tilgang med minste privilegier for produksjonslagre.

Start med skrivebeskyttede spørringer og metadatautforskning før du aktiverer arbeidsflyter som endrer lagerobjekter.

Feilsøking

Hvis du har problemer med å sette opp eller bruke Fabric datalager MCP-serveren, bruk følgende scenarioer for å feilsøke vanlige problemer.

MCP-serveren vises ikke som tilkoblet

Bekreft at MCP-konfigurasjonen er lagret riktig, at endepunkts-URL-en er korrekt, og at du har startet eller oppdatert MCP-serverne i Visual Studio Code etter å ha gjort endringer.

Copilot finner ikke lageret

Hvis du bruker det globale endepunktet, oppgi lagerkonteksten i chatten. Hvis du bruker item-scoped endepunkt, bekreft at arbeidsområde-ID og vare-ID er korrekte.

Autentisering feiler

Logg inn igjen med din Microsoft-konto. Sørg for at du bruker riktig leietaker og katalog.

Verktøykall feiler med tillatelsesfeil

Bekreft at du har den nødvendige Fabric-arbeidsplassrollen, elementtillatelser og SQL-tillatelser. Serveren omgår ikke Fabric-sikkerheten.

Agenten kan ikke liste opp skjemaer eller tabeller

Serveren eksponerer executeSQLkun . Be agenten bruke SQL-metadata-spørringer i stedet for å forvente separate verktøy for skjemaoppdagelse.

Eksempel:

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

Spørringsresultatene er uventede

Spør Copilot vise den genererte T-SQL-en før kjøring. Gå gjennom tabellnavn, joins, filtre, datologikk og aggregeringslogikk før du godkjenner verktøykallet.

Relatert innhold

  • Last updated on