Fabric tietovarasto MCP-palvelin (Esikatselu)

Koskee:✅ SQL-analytiikan päätepiste ja Microsoft Fabric -varasto

Etä-Fabric tietovarasto MCP-palvelin on isännöity MCP-päätelaite, joka mahdollistaa tekoälyagenttien työskennellä varaston kanssa luonnollisella kielellä. Model Context Protocolin (MCP) pohjalta rakennettu järjestelmä antaa agenteille hallitun tavan ajaa T-SQL-lauseita executeSQL työkalun kautta, tarkastaa tuloksia ja iteroida todellista varastokontekstia vastaan kunnioittaen Fabric-oikeuksia ja tietoturvarajoja.

Tässä artikkelissa opit:

  • Yhdistä etäpalvelimeen Fabric tietovarasto MCP-palvelimeen Visual Studio Code

  • Konfiguroi joko globaali päätepiste tai item-scoped-päätepiste

  • Käytä GitHub Copilot luodaksesi ja ajaaksesi T-SQL:n Fabric tietovarasto

  • Validoi yhteys testikyselyillä

Edellytykset

Varmista ennen aloittamista, että sinulla on:

  • Visual Studio Code: Asenna uusin versio Visual Studio Code:sta.

  • GitHub Copilot: Asenna ja kirjaudu sisään GitHub Copilot- ja GitHub Copilot Chat-palveluihin Visual Studio Code -tilassa.

  • Fabric tietovarasto pääsy: Tarvitset pääsyn vähintään yhteen Fabric tietovarasto- tai SQL-analytiikkapäätelaitteeseen.

  • Varaston käyttöoikeudet: Tarvitset tarvittavat Fabric-työtilan ja SQL-oikeudet ajaaksesi ne T-SQL-lauseet, joita pyydät agentin suorittamaan.

  • Varaston konteksti: Pidä työtilan ID ja varaston kohteen ID käytettävissä, jos aiot käyttää esineen laajuudelle suunnattua päätepistettä.

Valitse päätepiste

Fabric tietovarasto MCP-palvelin tarjoaa kaksi päätepistevaihtoehtoa käyttötapauksen mukaan. Valitse globaali päätepiste joustavaa varastovalintaa varten kehotteiden avulla tai esine-scoped-päätepiste, jolla yhdistät yhteyden tiettyyn varastoon.

Globaali päätepiste

Kun haluat yhdistää Fabric tietovarasto MCP-palvelimeen, anna varastokonteksti kehotteiden tai työkaluargumenttien avulla käyttämällä globaalia päätelaitetta:

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

Item-scoped -päätepiste

Käytä item-scoped-päätepistettä, kun haluat, että MCP-palvelinyhteys on sidottu tiettyyn Fabric tietovarasto kohteeseen.

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

Korvata:

  • <workspace-id>Fabric workspace ID:llä.

  • <item-id>Fabric tietovarasto esine-ID:llä.

Esine-laajuinen päätepiste on hyödyllinen, kun haluat agenttikokemuksen olevan sidottu tiettyyn varastoon etkä anna toistuvasti varaston kontekstia chatissa.

Käyttöönotto Visual Studio Codessa

Määritä Fabric tietovarasto MCP-palvelin Visual Studio Code lisäämällä palvelimen konfiguraatio MCP-asetustiedostoosi. Valitse globaali päätepiste joustavan varaston valintaan tai esine-scoped-päätepisteen välillä, jolla yhteys sidotaan tiettyyn varastoon.

Vaihtoehto 1: Määritä globaali päätepiste

Lisää seuraava palvelinkonfiguraatio Visual Studio Code MCP -konfiguraatiotiedostoosi:

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

Konfiguraation tallentamisen jälkeen käynnistä tai päivitä MCP-palvelimet Visual Studio Code:ssa.

Vaihtoehto 2: Konfiguroi kohde-kohdepäätepiste

Lisää seuraava palvelinkonfiguraatio Visual Studio Code MCP -konfiguraatiotiedostoosi:

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

Korvaa ja <item-id> -<workspace-id>arvot varastosi arvoilla.

Konfiguraation tallentamisen jälkeen käynnistä tai päivitä MCP-palvelimet Visual Studio Code:ssa.

Testaa yhteyttäsi

Kun olet konfiguroinut yhteyden, varmista, että asennus toimii.

  1. Käynnistä MCP-palvelin Visual Studio Code:ssa.

    • Avaa MCP-palvelinpaneeli.

    • Varmista, että Fabric tietovarasto MCP-palvelin näyttää olevan yhdistetty.

  2. Avaa GitHub Copilot Chat.

    • Käynnistä Copilot Chat Visual Studio Code:ssa.

    • Ota agenttitila käyttöön.

  3. Anna varastokonteksti, jos käytät globaalia päätepistettä.

    • Jos olet konfiguroinut globaalin päätepisteen, kerro Copilotille, mitä varastoa käyttää kehotteella, kuten:

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

    • Jos konfiguroit item-scoped-päätepisteen, palvelin on jo rajattu varaston kohteeseen päätepisteen URL-osoitteessa.

  4. Kysy kysymys.

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

  5. Valtuuta työkalujen käyttö.

    • Kun pyydetään, tarkista ja hyväksy työkalukutsu executeSQL .

    • Varmista todennus Microsoft-tunnuksillasi, jos pyydetään.

  6. Tarkista vastaus.

    • Copilot käyttää Fabric tietovarasto MCP-palvelinta suorittaakseen hyväksytyn T-SQL-lauseen ja palauttaa tuloksen chatissa.

Käytettävissä olevat työkalut

Fabric tietovarasto MCP-palvelin paljastaa yhden työkalun.

Työkalu Description
executeSQL Suorittaa hyväksytyn T-SQL-lauseen Fabric tietovarasto vastaan ja palauttaa tuloksen.

Palvelin ei tarjoa erillisiä työkaluja skeemien listaamiseen, taulujen kuvaamiseen, kyselyhistorian hakemiseen tai varaston metatietojen tarkasteluun. Voit silti suorittaa nämä työnkulut pyytämällä agenttia luomaan ja suorittamaan T-SQL:n .executeSQL

Esimerkiksi sen sijaan, että kutsuttaisiin erillinen taulun tunnistustyökalu, agentti voi käyttää executeSQL sitä vastaan-kyselyn INFORMATION_SCHEMA.TABLES tai muiden tuettujen järjestelmänäkymien kanssa.

Validoi esimerkkikehotteista

Käytä näitä kehotuksia varmistaaksesi, että palvelin pystyy generoimaan T-SQL:n, suorittamaan T-SQL:n ja selittämään tulokset.

Tutustu varastoesineisiin

  • Listaa kaikki tämän varaston skeemat.

  • Listaa kaikki taulukot ja näkymät ryhmiteltyinä skeeman mukaan.

  • Näytä taulukon sarakkeet, tietotyypit ja nollaus.dbo.Customers

Luo ja aja T-SQL

  • Kirjoita ja suorita T-SQL-kysely, joka palauttaa kymmenen parasta tuotetta liikevaihdon perusteella.

  • Suorita kysely, joka laskee rivit järjestystilan mukaan taulukossa Orders .

  • Luo kysely, joka yhdistää Orders, Customers, Products, ja Regions näyttämään tulot alueittain.

Ymmärrä ja paranna kyselyitä

  • Selitä, mitä tämä T-SQL-kysely tekee ennen sen suorittamista.

  • Kirjoita tämä kysely uudelleen, jotta se olisi helpompi lukea muuttamatta tulosta.

  • Ehdota parannuksia tähän kyselymalliin ja näytä sitten uudistettu T-SQL.

Valvo varaston toimintaa

  • Näytä viimeisimmät kyselyt tälle varastolle.

  • Etsi pitkään jatkuneita kyselyjä tai sessioita, jotka saattavat vaatia huomiota.

  • Tiivistäkää viimeaikaiset kyselyvirheet ja ryhmittele ne todennäköisten juurisyyn mukaan.

Note

Tarkat seurantakyselyt riippuvat varastoympäristön järjestelmänäkymistä.

Suojaus ja oikeudet

Fabric tietovarasto MCP-palvelin käyttää kirjautuneen käyttäjän identiteettiä ja kunnioittaa Fabric oikeuksia. Käyttäjät voivat ajaa vain SQL-lauseita, joita heidän identiteettinsä saa suorittaa Fabric tietovarasto.

Työkalukutsut, jotka executeSQL vaativat nimenomaisen käyttäjän hyväksynnän MCP-asiakkaassa. Tarkista generoitu T-SQL ennen suorittamista executeSQL , erityisesti kirjoitusoperaatioille kuten CREATE, ALTER, DROP, INSERT, UPDATE, tai DELETE.

Käytä vähiten etuoikeutettujen pääsyä tuotantovarastoihin.

Aloita vain luku -kyselyillä ja metatietojen tutkinnalla ennen kuin otat käyttöön työnkulut, jotka muokkaavat varaston objekteja.

Vianmääritys

Jos sinulla on ongelmia Fabric tietovarasto MCP-palvelimen asennuksessa tai käytössä, käytä seuraavia skenaarioita yleisten ongelmien selvittämiseen.

MCP-palvelin ei näy yhdistettynä

Varmista, että MCP-konfiguraatio on tallennettu oikein, päätepisteen URL on oikea ja että olet käynnistänyt tai päivittänyt MCP-palvelimet Visual Studio Code:ssa muutosten jälkeen.

Copilot ei löydä varastoa

Jos käytät globaalia päätelaitetta, anna varaston konteksti chatissa. Jos käytät item-scoped-päätepistettä, varmista, että työtilan ID ja item ID ovat oikein.

Todennus epäonnistuu

Kirjaudu uudelleen sisään Microsoft-tili-tililläsi. Varmista, että käytät oikeaa vuokralaista ja hakemistoa.

Työkalukutsut epäonnistuvat käyttöoikeusvirheillä

Varmista, että sinulla on vaadittu Fabric-työtilan rooli, esineiden käyttöoikeudet ja SQL-oikeudet. Palvelin ei kierrä Fabric-tietoturvaa.

Agentti ei voi listata skeemoja tai taulukoita

Palvelin paljastaa executeSQLvain . Pyydä agenttia käyttämään SQL-metatietokyselyitä sen sijaan, että odottaisit erillisiä skeeman löytötyökaluja.

Esimerkki:

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

Kyselytulokset ovat odottamattomia

Kysy Copilotilta näyttämään generoidun T-SQL:n ennen suoritusta. Käy läpi taulujen nimet, liitokset, suodattimet, päivämäärälogiikka ja aggregointilogiikka ennen työkalukutsun hyväksymistä.

Liittyvä sisältö

  • Last updated on