Servidor MCP do Fabric Data Warehouse (Pré-visualização)

Aplica-se a:✅ Ponto Final de Análise SQL e Armazém no Microsoft Fabric

O servidor remoto Fabric Data Warehouse MCP é um endpoint MCP alojado que permite aos agentes de IA trabalhar com um armazém usando linguagem natural. Baseado no Model Context Protocol (MCP), oferece aos agentes uma forma controlada de executar instruções T-SQL através da ferramenta executeSQL, inspecionar os resultados e iterar com base no contexto real do armazém de dados, respeitando as permissões e os limites de segurança do Fabric.

Este artigo mostra-lhe como:

  • Liga-te ao servidor remoto Fabric Data Warehouse MCP em Visual Studio Code

  • Configure o endpoint global ou um endpoint no âmbito de um item

  • Use GitHub Copilot para gerar e executar T-SQL contra Fabric Data Warehouse

  • Valide a ligação com consultas de teste

Pré-requisitos

Antes de começar, certifique-se de que tem:

  • Visual Studio Code: Instale a versão mais recente do Visual Studio Code.

  • GitHub Copilot: Instale e inicie sessão no GitHub Copilot e no GitHub Copilot Chat no Visual Studio Code.

  • Acesso ao Fabric Data Warehouse: Precisa de ter acesso a, pelo menos, um Fabric Data Warehouse ou a um ponto final de análise SQL.

  • Permissões de armazém: Precisa do espaço de trabalho Fabric e das permissões SQL necessárias para executar as instruções T-SQL que pede ao agente para executar.

  • Contexto do armazém: Tenha o ID do espaço de trabalho e o ID do item do armazém disponíveis caso pretenda utilizar o endpoint ao nível do item.

Escolha um ponto final

O servidor Fabric Data Warehouse MCP oferece duas opções de endpoint dependendo do seu caso de uso. Escolha o ponto de extremidade global para uma seleção flexível de armazéns mediante instruções, ou o ponto de extremidade específico do item para associar a ligação a um armazém específico.

Ponto final global

Quando quiser estabelecer ligação ao servidor MCP do Fabric Data Warehouse, forneça o contexto do armazém através de pedidos ou argumentos de ferramentas, utilizando o endpoint global:

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

Ponto de extremidade no âmbito do item

Utilize o ponto final com âmbito de item quando pretender que a ligação ao servidor MCP esteja associada a um item específico do Fabric Data Warehouse.

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

Substituir:

  • <workspace-id> com o ID do espaço de trabalho do Fabric.

  • <item-id>com o Fabric Data Warehouse ID de item.

O endpoint ao nível do item é útil quando se pretende que a experiência do agente fique associada a um armazém específico e evitar fornecer repetidamente o contexto do armazém no chat.

Configurado em Visual Studio Code

Configura o servidor MCP Fabric Data Warehouse em Visual Studio Code adicionando a configuração do servidor ao ficheiro de definições MCP. Escolha entre o ponto de extremidade global para uma seleção flexível de armazéns ou o ponto de extremidade ao nível do item para associar a ligação a um armazém específico.

Opção 1: Configurar o endpoint global

Adicione a seguinte configuração de servidor ao seu ficheiro de configuração Visual Studio Code MCP:

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

Depois de guardar a configuração, reinicie ou atualize os servidores MCP no Visual Studio Code.

Opção 2: Configurar o ponto final ao nível do item

Adicione a seguinte configuração de servidor ao seu ficheiro de configuração Visual Studio Code MCP:

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

Substitua o <workspace-id> e o <item-id> pelos valores do seu armazém.

Depois de guardar a configuração, reinicie ou atualize os servidores MCP no Visual Studio Code.

Teste a sua ligação

Depois de configurares a ligação, verifica se a configuração funciona.

  1. Inicie o servidor MCP no Visual Studio Code.

    • Abre o painel de servidores MCP.

    • Confirma que o servidor MCP Fabric Data Warehouse aparece como ligado.

  2. Abra o GitHub Copilot Chat.

    • Lançar o Copilot Chat no Visual Studio Code.

    • Ativar o modo agente.

  3. Forneça o contexto do armazém caso esteja a usar o endpoint global.

    • Se configurou o endpoint global, diga ao Copilot qual armazém usar com um prompt como:

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

    • Se configurou o endpoint com âmbito ao nível do item, o servidor já está limitado ao item de armazém na URL do endpoint.

  4. Faça uma pergunta.

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

  5. Autorizar o uso de ferramentas.

    • Quando lhe for solicitado, analise e aprove a chamada de ferramenta executeSQL.

    • Autentique-se com as suas credenciais da Microsoft, se lhe for solicitado.

  6. Veja a resposta.

    • Copilot utiliza o servidor MCP Fabric Data Warehouse para executar a instrução T-SQL aprovada e devolve o resultado no chat.

Ferramentas disponíveis

O servidor MCP Fabric Data Warehouse expõe uma ferramenta.

Tool Description
executeSQL Executa uma instrução T-SQL aprovada contra Fabric Data Warehouse e devolve o resultado.

O servidor não expõe ferramentas separadas para listar esquemas, descrever tabelas, recuperar o histórico de consultas ou inspecionar metadados do armazém. Ainda podes concluir esses fluxos de trabalho pedindo ao agente para gerar e executar T-SQL através de executeSQL.

Por exemplo, em vez de chamar uma ferramenta separada de descoberta de tabelas, o agente pode usar executeSQL com uma consulta a INFORMATION_SCHEMA.TABLES ou a outras vistas de sistema suportadas.

Validar com exemplos de comandos

Use estes prompts para confirmar que o servidor consegue gerar T-SQL, executar T-SQL e explicar os resultados.

Explorar objetos do armazém

  • Liste todos os esquemas neste armazém de dados.

  • Liste todas as tabelas e vistas agrupadas por esquema.

  • Mostre as colunas, os tipos de dados e a nulidade da dbo.Customers tabela.

Gerar e executar T-SQL

  • Escreve e executa uma consulta T-SQL que devolve os 10 produtos principais por receita.

  • Executa uma consulta que conte as linhas pelo estado da ordem na Orders tabela.

  • Crie uma consulta que junte Orders, Customers, Products, e Regions para mostrar a receita por região.

Compreender e melhorar as consultas

  • Explica o que faz esta consulta T-SQL antes de a executar.

  • Reescreva esta consulta para facilitar a leitura sem alterar o resultado.

  • Sugira melhorias a este padrão de consulta e depois mostra o T-SQL revisto.

Monitorizar a atividade do armazém

  • Mostrar a atividade recente de consultas para este armazém.

  • Encontre questões ou sessões de longa duração que possam precisar de atenção.

  • Resume falhas recentes de consultas e agrupe-as pela causa raiz provável.

Note

As consultas exatas de monitorização dependem das visualizações do sistema disponíveis no ambiente do armazém.

Segurança e permissões

O servidor MCP do Fabric Data Warehouse utiliza a identidade do utilizador com sessão iniciada e respeita as permissões do Fabric. Os utilizadores só podem executar instruções SQL que a sua identidade está autorizada a executar no Fabric Data Warehouse.

Chamadas de ferramenta que executeSQL devem exigir aprovação explícita do utilizador no cliente MCP. Revise o T-SQL gerado antes de permitir executeSQL a execução, especialmente para operações de escrita como CREATE, ALTER, DROP, INSERT, UPDATE, ou DELETE.

Utilize o acesso com o mínimo de privilégios para armazéns de produção.

Comece com consultas apenas de leitura e exploração de metadados antes de ativar fluxos de trabalho que modificam objetos de armazém.

Troubleshoot

Se tiver problemas a configurar ou usar o servidor MCP Fabric Data Warehouse, utilize os seguintes cenários para resolver problemas comuns.

O servidor MCP não aparece como ligado

Confirma se a configuração MCP está guardada corretamente, que a URL do endpoint está correta e que reiniciaste ou atualizaste os servidores MCP no Visual Studio Code depois de fazeres alterações.

O Copilot não consegue encontrar o armazém

Se estiveres a usar o endpoint global, fornece o contexto do armazém de dados na conversa. Se estiveres a usar o endpoint ao nível do item, confirma que o ID da área de trabalho e o ID do item estão corretos.

Falha na autenticação

Inicie sessão novamente com a sua conta conta Microsoft. Certifica-te de que estás a usar o tenant e o diretório corretos.

As chamadas a ferramentas falham devido a erros de permissão

Confirme que tem o papel exigido no espaço de trabalho do Fabric, permissões de itens e permissões SQL. O servidor não contorna a segurança do Fabric.

O agente não pode listar esquemas ou tabelas

O servidor só expõe executeSQL. Pede ao agente para usar consultas de metadados SQL em vez de esperar ferramentas separadas de descoberta de esquemas.

Example:

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

Os resultados das consultas são inesperados

Peça ao Copilot para que mostre o T-SQL gerado antes da execução. Reveja os nomes das tabelas, as junções, os filtros, a lógica de datas e a lógica de agregação antes de aprovar a chamada à ferramenta.

Conteúdo relacionado

  • Last updated on