Fabric Data Warehouse servidor MCP (versão prévia)

Aplica-se a:✅ Endpoint de análise de SQL e Armazém de Dados no Microsoft Fabric

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

Este artigo mostra como:

  • Conectar-se ao servidor MCP Fabric Data Warehouse remoto no Visual Studio Code

  • Configurar o ponto de extremidade global ou o ponto de extremidade no escopo do item

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

  • Validar a conexão com consultas de teste

Prerequisites

Antes de começar, verifique se você 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: Você precisa de acesso a pelo menos um Fabric Data Warehouse ou endpoint de análise SQL.

  • Permissões do Warehouse: Você precisa das permissões necessárias no workspace do Fabric e no SQL para executar as instruções T-SQL cuja execução você solicita ao agente.

  • Contexto do Warehouse: tenha o ID do workspace e o ID do item do Warehouse disponíveis se você planeja usar o endpoint com escopo no item.

Escolher um ponto de extremidade

O servidor MCP Fabric Data Warehouse oferece duas opções de ponto de extremidade, dependendo do seu caso de uso. Escolha o ponto de extremidade global para seleção flexível do warehouse por meio de prompts ou o ponto de extremidade com escopo de item para associar a conexão a um warehouse específico.

Ponto de extremidade global

Quando quiser se conectar ao servidor MCP do Fabric Data Warehouse, forneça o contexto do data warehouse por meio de prompts ou de argumentos de ferramenta, usando o endpoint global:

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

Ponto de extremidade com escopo de item

Use o endpoint com escopo no item quando quiser que a conexão com o servidor MCP fique vinculada 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 workspace do Fabric.

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

O endpoint com escopo no item é útil quando você deseja que a experiência do agente fique vinculada a um armazém específico e evitar fornecer repetidamente o contexto do armazém no chat.

Configurar no Visual Studio Code

Configure o servidor MCP Fabric Data Warehouse em Visual Studio Code adicionando a configuração do servidor ao arquivo de configurações do MCP. Escolha entre o endpoint global para seleção flexível de armazém ou o endpoint com escopo no item para vincular a conexão a um armazém específico.

Opção 1: Configurar o ponto de extremidade global

Adicione a seguinte configuração de servidor ao arquivo de configuração do MCP Visual Studio Code:

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

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

Opção 2: Configurar o endpoint com escopo no item

Adicione a seguinte configuração de servidor ao arquivo de configuração do MCP 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"
      }
   }
}

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

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

Testar a conexão

Depois de configurar a conexão, verifique se a configuração funciona.

  1. Inicie o servidor MCP no Visual Studio Code.

    • Abra o painel de servidores MCP.

    • Confirme se o servidor MCP Fabric Data Warehouse é mostrado como conectado.

  2. Abra o GitHub Copilot Chat.

    • Inicie Copilot Chat em Visual Studio Code.

    • Habilitar o modo de agente.

  3. Forneça o contexto do armazém se estiver usando o endpoint global.

    • Se você configurou o endpoint global, informe ao Copilot qual armazém de dados usar com um prompt como:

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

    • Se você configurou o endpoint com escopo no item, o servidor já está limitado ao item do armazém na URL do endpoint.

  4. Faça uma pergunta.

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

  5. Autorizar o uso da ferramenta.

    • Quando solicitado, revise e aprove a chamada de ferramenta executeSQL.

    • Autentique com suas credenciais de Microsoft, se solicitado.

  6. Examine a resposta.

    • Copilot usa o servidor MCP Fabric Data Warehouse para executar a instrução T-SQL aprovada e retorna 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 no Fabric Data Warehouse e retorna o resultado.

O servidor não expõe ferramentas separadas para listar esquemas, descrever tabelas, recuperar histórico de consultas ou inspecionar metadados do warehouse. Você ainda pode concluir esses fluxos de trabalho solicitando que o agente gere e execute o T-SQL por meio executeSQL.

Por exemplo, em vez de chamar uma ferramenta separada de descoberta de tabelas, o agente pode usar executeSQL em uma consulta a INFORMATION_SCHEMA.TABLES ou a outras exibições do sistema compatíveis.

Validar com prompts de exemplo

Use esses prompts para confirmar se o servidor pode gerar T-SQL, executar T-SQL e explicar os resultados.

Explorar objetos do armazém

  • Liste todos os esquemas neste data warehouse.

  • Listar todas as tabelas e exibições agrupadas por esquema.

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

Gerar e executar o T-SQL

  • Escreva e execute uma consulta T-SQL que retorna os 10 principais produtos por receita.

  • Execute uma consulta que conta linhas por status de ordem na Orders tabela.

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

Entender e aprimorar consultas

  • Explique o que essa consulta T-SQL faz antes de executá-la.

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

  • Sugira melhorias nesse padrão de consulta e mostre o T-SQL revisado.

Monitore a atividade do armazém

  • Mostrar atividade de consulta recente para este armazém.

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

  • Resumir falhas de consulta recentes e agrupá-las por causa raiz provável.

Note

As consultas de monitoramento específicas dependem das visões do sistema disponíveis no ambiente de data warehouse.

Segurança e permissões

O servidor MCP Fabric Data Warehouse usa a identidade do usuário conectado e respeita as permissões de Fabric. Os usuários só podem executar instruções SQL que sua identidade tem permissão para executar em Fabric Data Warehouse.

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

Use acesso de menor privilégio para os ambientes de produção.

Comece com consultas de somente leitura e exploração de metadados antes de habilitar fluxos de trabalho que modificam objetos do data warehouse.

Troubleshoot

Se você tiver problemas para configurar ou usar o servidor MCP Fabric Data Warehouse, use os cenários a seguir para solucionar problemas comuns.

O servidor MCP não aparece como conectado

Confirme se a configuração do MCP foi salva corretamente, a URL do ponto de extremidade está correta e se você reiniciou ou atualizou servidores MCP no Visual Studio Code após fazer alterações.

Copilot não consegue encontrar o armazém

Se você estiver usando o endpoint global, forneça o contexto do armazém de dados no chat. Se você estiver usando o endpoint no escopo do item, confirme se o ID do workspace e o ID do item estão corretos.

Falha na autenticação

Entre novamente com seu conta Microsoft. Verifique se você está usando o locatário e o diretório corretos.

As chamadas à ferramenta falham devido a erros de permissão

Confirme se você tem a função necessária no espaço de trabalho do Fabric, as permissões do item e as 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. Peça ao agente para usar consultas de metadados sql em vez de esperar ferramentas de descoberta de esquema separadas.

Exemplo:

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

Os resultados da consulta são inesperados

Peça ao Copilot para mostrar o T-SQL gerado antes da execução. Examine nomes de tabela, junções, filtros, lógica de data e lógica de agregação antes de aprovar a chamada de ferramenta.

Conteúdo relacionado

  • Last updated on