server MCP di Fabric Data Warehouse (anteprima)

Si applica a:✅ endpoint di analisi SQL e magazzino dati in Microsoft Fabric

Il server MCP Fabric Data Warehouse remoto è un endpoint MCP ospitato che consente agli agenti di intelligenza artificiale di lavorare con un warehouse usando il linguaggio naturale. Basato sul protocollo MCP (Model Context Protocol), offre agli agenti un modo regolamentato per eseguire istruzioni T-SQL tramite lo executeSQL strumento, esaminare i risultati e scorrere il contesto del warehouse reale rispettando al tempo stesso le autorizzazioni e i limiti di sicurezza Fabric.

Questo articolo illustra come:

  • Connettersi al server remoto MCP di Fabric Data Warehouse in Visual Studio Code

  • Configura l'endpoint globale o un endpoint con ambito a livello di elemento

  • Usare GitHub Copilot per generare ed eseguire T-SQL in Fabric Data Warehouse

  • Convalidare la connessione con le query di test

Prerequisiti

Prima di iniziare, assicurati di avere:

  • Visual Studio Code: installare la versione più recente di Visual Studio Code.

  • GitHub Copilot: installare e accedere a GitHub Copilot e GitHub Copilot Chat in Visual Studio Code.

  • Accesso a Fabric Data Warehouse: è necessario avere accesso ad almeno un data warehouse di Fabric o endpoint di analisi SQL.

  • Autorizzazioni di Warehouse: per eseguire le istruzioni T-SQL che si chiede all'agente di eseguire, è necessario disporre delle autorizzazioni richieste per l'area di lavoro Fabric e di quelle SQL.

  • Contesto del magazzino: avere a disposizione l'ID dell'area di lavoro e l'ID dell'articolo di magazzino se si prevede di utilizzare l'endpoint con ambito a livello di elemento.

Scegliere un endpoint

Il server MCP Fabric Data Warehouse offre due opzioni endpoint a seconda del caso d'uso. Scegliere l'endpoint globale per la selezione flessibile del magazzino tramite richieste o l'endpoint con ambito articolo per associare la connessione a un warehouse specifico.

Endpoint globale

Quando vuoi connetterti al server MCP di Fabric Data Warehouse, fornisci il contesto del data warehouse tramite prompt o argomenti dello strumento, utilizzando l'endpoint globale:

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

Endpoint con ambito a livello di elemento

Usare l'endpoint con ambito a livello di elemento quando si desidera che la connessione del server MCP sia vincolata a un elemento specifico di Fabric Data Warehouse.

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

Sostituire:

  • <workspace-id>con l'ID dell'area di lavoro Fabric.

  • <item-id> con l'ID dell'elemento Fabric Data Warehouse.

L'endpoint con ambito a livello di articolo è utile quando si vuole che l'esperienza dell'agente sia vincolata a un magazzino specifico, evitando così di dover fornire ripetutamente il contesto del magazzino in chat.

Configurare in Visual Studio Code

Configurare il server MCP Fabric Data Warehouse in Visual Studio Code aggiungendo la configurazione del server al file di impostazioni MCP. Scegliere tra l'endpoint globale per la selezione flessibile del magazzino o l'endpoint con ambito articolo per associare la connessione a un magazzino specifico.

Opzione 1: Configurare l'endpoint globale

Aggiungi la seguente configurazione del server nel file di configurazione MCP di Visual Studio Code:

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

Dopo aver salvato la configurazione, riavviare o aggiornare i server MCP in Visual Studio Code.

Opzione 2: Configurare l'endpoint con ambito a livello di elemento

Aggiungi la seguente configurazione del server al file di configurazione MCP di Visual Studio Code:

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

Sostituire il <workspace-id> e il <item-id> con i valori del proprio magazzino.

Dopo aver salvato la configurazione, riavviare o aggiornare i server MCP in Visual Studio Code.

Test della connessione

Dopo aver configurato la connessione, verificare che l'installazione funzioni.

  1. Avviare il server MCP in Visual Studio Code.

    • Aprire il pannello server MCP.

    • Verificare che il server MCP Fabric Data Warehouse sia visualizzato come connesso.

  2. Apri GitHub Copilot Chat.

    • Avviare Copilot Chat in Visual Studio Code.

    • Abilitare la modalità agente.

  3. Specifica il contesto del warehouse se utilizzi l'endpoint globale.

    • Se l'endpoint globale è stato configurato, indicare Copilot quale warehouse usare con un prompt simile al seguente:

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

    • Se hai configurato l'endpoint con ambito a livello di elemento, il server è già limitato all'articolo di magazzino nell'URL dell'endpoint.

  4. Fai una domanda.

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

  5. Autorizzare l'utilizzo dello strumento.

    • Quando richiesto, verificare e approvare la chiamata dello executeSQL strumento.

    • Eseguire l'autenticazione con le credenziali Microsoft, se richiesto.

  6. Esaminare la risposta.

    • Copilot usa il server MCP Fabric Data Warehouse per eseguire l'istruzione T-SQL approvata e restituisce il risultato nella chat.

Strumenti disponibili

Il server MCP Fabric Data Warehouse espone uno strumento.

Tool Description
executeSQL Esegue un'istruzione T-SQL approvata su Fabric Data Warehouse e restituisce il risultato.

Il server non espone strumenti separati per elencare gli schemi, descrivere le tabelle, recuperare la cronologia delle query o esaminare i metadati del warehouse. È comunque possibile completare tali flussi di lavoro chiedendo all'agente di generare ed eseguire T-SQL tramite executeSQL.

Ad esempio, invece di chiamare uno strumento di individuazione tabelle separato, l'agente può usare executeSQL con una query su INFORMATION_SCHEMA.TABLES o altre viste di sistema supportate.

Convalidare con richieste di esempio

Usare queste istruzioni per verificare che il server possa generare T-SQL, eseguire T-SQL e spiegare i risultati.

Esplora gli oggetti del magazzino

  • Elenca tutti gli schemi in questo magazzino.

  • Elencare tutte le tabelle e le viste raggruppate per schema.

  • Mostra le colonne, i tipi di dati e la possibilità di valori NULL della tabella dbo.Customers.

Generare ed eseguire T-SQL

  • Scrivere ed eseguire una query T-SQL che restituisce i primi 10 prodotti in base ai ricavi.

  • Eseguire una query che conta le righe in base allo stato dell'ordine nella Orders tabella.

  • Crea una query che combina Orders, Customers, Products e Regions per mostrare i ricavi per area geografica.

Comprendere e migliorare le query

  • Spiegare le operazioni eseguite da questa query T-SQL prima di eseguirla.

  • Riscrivere questa query per semplificare la lettura senza modificare il risultato.

  • Suggerire miglioramenti a questo modello di query, quindi visualizzare il T-SQL modificato.

Monitorare l'attività del magazzino

  • Mostra l'attività recente delle query per questo data warehouse.

  • Individua query o sessioni di lunga durata che potrebbero richiedere attenzione.

  • Riepilogare gli errori di query recenti e raggrupparli per probabile causa radice.

Annotazioni

Le query di monitoraggio esatte dipendono dalle viste di sistema disponibili nell'ambiente warehouse.

Sicurezza e autorizzazioni

Il server MCP Fabric Data Warehouse usa l'identità dell'utente connesso e rispetta le autorizzazioni Fabric. Gli utenti possono eseguire solo istruzioni SQL che la loro identità è autorizzata a eseguire in Fabric Data Warehouse.

Le invocazioni di strumenti che executeSQL devono richiedere l'approvazione esplicita dell'utente nel client MCP. Esaminare il T-SQL generato prima di consentire a executeSQL di eseguirlo, in particolare per operazioni di scrittura come CREATE, ALTER, DROP, INSERT, UPDATE o DELETE.

Usare l'accesso con privilegi minimi per i magazzini di produzione.

Iniziare con le query di sola lettura e l'esplorazione dei metadati prima di abilitare i flussi di lavoro che modificano gli oggetti warehouse.

Troubleshoot

Se si verificano problemi durante la configurazione o l'uso del server MCP Fabric Data Warehouse, usare gli scenari seguenti per risolvere i problemi comuni.

Il server MCP non viene visualizzato come connesso

Verificare che la configurazione MCP sia stata salvata correttamente, l'URL dell'endpoint sia corretto e che i server MCP siano stati riavviati o aggiornati in Visual Studio Code dopo aver apportato modifiche.

Copilot non riesce a trovare il magazzino

Se utilizzi l'endpoint globale, specifica in chat il contesto del data warehouse. Se si utilizza l'endpoint con ambito a livello di elemento, verificare che l'ID dell'area di lavoro e l'ID dell'elemento siano corretti.

L'autenticazione non riesce

Accedere di nuovo con il account Microsoft. Assicurarsi di usare il tenant e la directory corretti.

Le chiamate agli strumenti hanno esito negativo con errori di autorizzazione

Verificate di disporre del ruolo necessario nell'area di lavoro di Fabric, delle autorizzazioni sugli elementi e delle autorizzazioni SQL. Il server non aggira la sicurezza di Fabric.

L'agente non può elencare schemi o tabelle

Il server espone solo executeSQL. Chiedere all'agente di usare query di metadati SQL invece di prevedere strumenti di individuazione dello schema separati.

Esempio:

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

I risultati delle query sono imprevisti

Chiedi a Copilot di visualizzare il T-SQL generato prima dell'esecuzione. Esaminare i nomi delle tabelle, i join, i filtri, la logica di data e la logica di aggregazione prima di approvare la chiamata allo strumento.

Contenuti correlati

  • Last updated on