Fabric Data Warehouse servidor MCP (versión preliminar)

Aplicable a:✅ Punto final de análisis SQL y Almacén en Microsoft Fabric

El servidor mcp remoto Fabric Data Warehouse es un punto de conexión de MCP hospedado que permite a los agentes de inteligencia artificial trabajar con un almacenamiento mediante lenguaje natural. Basado en el Protocolo de Contexto de Modelo (MCP), proporciona a los agentes una forma controlada de ejecutar instrucciones T-SQL a través de la herramienta executeSQL, inspeccionar los resultados e iterar con el contexto real del almacén de datos, respetando al mismo tiempo los permisos de Fabric y los límites de seguridad.

En este artículo aprenderá a:

• Conexión al servidor MCP de Fabric Data Warehouse remoto en Visual Studio Code

• Configurar el punto de conexión global o un punto de conexión específico de un elemento

• Use GitHub Copilot para generar y ejecutar T-SQL en Fabric Data Warehouse

• Validación de la conexión con consultas de prueba

Prerequisites

Antes de comenzar, asegúrese de que tiene:

• Visual Studio Code: instale la versión más reciente de Visual Studio Code.

  • Descargar Visual Studio Code

• GitHub Copilot: instale e inicie sesión en GitHub Copilot y GitHub Copilot Chat en Visual Studio Code.

  • Extensión de GitHub Copilot
  • Extensión de Chat de Copilot de GitHub

• Acceso a Fabric Data Warehouse: Necesita acceso a al menos un punto de conexión de análisis de SQL o a un Fabric Data Warehouse.

• Permisos de Warehouse: necesita los permisos necesarios del área de trabajo de Fabric y de SQL para ejecutar las instrucciones T-SQL que le pida al agente que ejecute.

• Contexto del almacén: Tenga a mano el identificador del área de trabajo y el identificador del elemento del almacén si tiene previsto usar el endpoint con ámbito de elemento.

Elección de un punto de conexión

El Fabric Data Warehouse servidor MCP ofrece dos opciones de punto de conexión en función del caso de uso. Elija el punto de conexión global para la selección de almacenamiento flexible mediante avisos o el punto de conexión con ámbito de elemento para enlazar la conexión a un almacenamiento específico.

Punto de conexión global

Cuando quiera conectarse al servidor MCP de Fabric Data Warehouse, proporcione el contexto del almacén de datos mediante instrucciones o argumentos de la herramienta usando el punto de conexión global:

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

Punto de conexión con ámbito de elemento

Use el punto de conexión con ámbito de elemento cuando desee que la conexión del servidor MCP esté enlazada a un elemento de Fabric Data Warehouse específico.

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

Reemplazar:

• <workspace-id> con el identificador del área de trabajo de Fabric.

• <item-id> con el identificador del elemento de Fabric Data Warehouse.

El endpoint con ámbito de elemento es útil cuando quiere que la experiencia del agente esté vinculada a un almacén específico y no tener que proporcionar repetidamente el contexto del almacén en el chat.

Configuración en Visual Studio Code

Configura el servidor MCP de Fabric Data Warehouse en Visual Studio Code agregando la configuración del servidor a tu archivo de configuración de MCP. Elija entre el punto de conexión global para la selección de almacenamiento flexible o el punto de conexión con ámbito de elemento para enlazar la conexión a un almacenamiento específico.

Opción 1: Configurar el punto de conexión global

Agregue la siguiente configuración del servidor al archivo de configuración de MCP de Visual Studio Code:

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

Después de guardar la configuración, reinicie o actualice los servidores MCP en Visual Studio Code.

Opción 2: Configurar el punto de conexión con ámbito de elemento

Agregue la siguiente configuración del servidor al archivo de configuración de MCP de 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"
      }
   }
}

Sustituya <workspace-id> y <item-id> por los valores de su almacén.

Después de guardar la configuración, reinicie o actualice los servidores MCP en Visual Studio Code.

Prueba de la conexión

Después de configurar la conexión, compruebe que el programa de instalación funciona.

1. Inicie el servidor MCP en Visual Studio Code.

   • Abra el panel Servidores MCP.

   • Confirme que el Fabric Data Warehouse servidor MCP se muestra como conectado.

2. Abra Copilot Chat de GitHub.

   • Inicie Copilot Chat en Visual Studio Code.

   • Habilite el modo de agente.

3. Proporcione el contexto de almacenamiento si usa el punto de conexión global.

   • Si has configurado el endpoint global, indícale a Copilot qué almacén de datos debe usar con una instrucción como esta:

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

   • Si configuró el extremo con ámbito de artículo, el servidor ya tiene como ámbito el artículo de almacén en la URL del extremo.

4. Formular una pregunta.

   • Example:

   What tables and views are in this warehouse?
   

   • Example:

   Show me the top 10 products by sales revenue.
   

5. Autorizar el uso de la herramienta.

   • Cuando se le solicite, revise y apruebe la executeSQL llamada de herramienta.

   • Autentíquese con las credenciales de Microsoft si se solicita.

6. Revise la respuesta.

   • Copilot usa el servidor MCP de Fabric Data Warehouse para ejecutar la instrucción T-SQL aprobada y devuelve el resultado en el chat.

Herramientas disponibles

El servidor MCP de Fabric Data Warehouse expone una herramienta.

Tool	Description
executeSQL	Ejecuta una instrucción T-SQL aprobada en Fabric Data Warehouse y devuelve el resultado.

El servidor no expone herramientas independientes para enumerar esquemas, describir tablas, recuperar historial de consultas ni inspeccionar metadatos de almacenamiento. Aún puede completar esos flujos de trabajo pidiendo al agente que genere y ejecute T-SQL mediante executeSQL.

Por ejemplo, en lugar de llamar a una herramienta de detección de tablas independiente, el agente puede usar executeSQL con una consulta en INFORMATION_SCHEMA.TABLES u otras vistas del sistema compatibles.

Valida con indicaciones de ejemplo

Use estas indicaciones para confirmar que el servidor puede generar T-SQL, ejecutar T-SQL y explicar los resultados.

Exploración de objetos de almacenamiento

• Enumere todos los esquemas de este almacén.

• Enumera todas las tablas y vistas agrupadas por esquema.

• Mostrar las columnas, los tipos de datos y la nulabilidad de la dbo.Customers tabla.

Generación y ejecución de T-SQL

• Escriba y ejecute una consulta de T-SQL que devuelva los 10 productos principales por ingresos.

• Ejecute una consulta que cuente filas por estado de orden en la Orders tabla.

• Cree una consulta que combine Orders, Customers, Productsy Regions para mostrar los ingresos por región.

Descripción y mejora de las consultas

• Explicar lo que hace esta consulta de T-SQL antes de ejecutarla.

• Vuelva a escribir esta consulta para facilitar la lectura sin cambiar el resultado.

• Sugerir mejoras en este patrón de consulta y, a continuación, mostrar el T-SQL revisado.

Supervisión de la actividad del almacenamiento

• Mostrar la actividad de consulta reciente para este almacenamiento.

• Busque consultas o sesiones de larga ejecución que puedan requerir atención.

• Resumir los errores de consulta recientes y agruparlos por causa raíz probable.

Note

Las consultas de supervisión exactas dependen de las vistas del sistema disponibles en el entorno de almacenamiento.

Seguridad y permisos

El Fabric Data Warehouse servidor MCP usa la identidad del usuario que ha iniciado sesión y respeta los permisos Fabric. Los usuarios solo pueden ejecutar instrucciones SQL que su identidad pueda ejecutar en Fabric Data Warehouse.

Las llamadas a herramientas que executeSQL deben requerir la aprobación explícita del usuario en el cliente MCP. Revise el T-SQL generado antes de permitir que executeSQL se ejecute, especialmente para operaciones de escritura como CREATE, ALTER, DROP, INSERT, UPDATE o DELETE.

Use el acceso con privilegios mínimos para los almacenes de producción.

Comience con consultas de solo lectura y exploración de metadatos antes de habilitar flujos de trabajo que modifiquen objetos de almacenamiento.

Troubleshoot

Si tiene problemas para configurar o usar el servidor MCP de Fabric Data Warehouse, use los siguientes escenarios para solucionar problemas comunes.

El servidor MCP no se muestra como conectado

Confirme que la configuración de MCP se guarda correctamente, la dirección URL del punto de conexión es correcta y que ha reiniciado o actualizado los servidores MCP en Visual Studio Code después de realizar cambios.

Copilot no puede encontrar el almacén

Si usa el punto de conexión global, proporcione el contexto de almacenamiento en el chat. Si usa el punto de conexión con ámbito de elemento, confirme que el identificador del área de trabajo y el identificador de elemento son correctos.

Error de autenticación

Vuelva a iniciar sesión con el cuenta Microsoft. Asegúrese de que usa el inquilino y el directorio correctos.

Las llamadas a herramientas fallan por errores de permisos

Asegúrese de que tiene el rol requerido en el área de trabajo de Fabric, los permisos del elemento y los permisos de SQL. El servidor no elude la seguridad de Fabric.

El agente no puede enumerar esquemas ni tablas

El servidor solo expone executeSQL. Pida al agente que use consultas de metadatos SQL en lugar de esperar herramientas de detección de esquemas independientes.

Example:

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

Los resultados de la consulta son inesperados

Pida a Copilot que muestre el T-SQL generado antes de ejecutarlo. Revise los nombres de tabla, las combinaciones, los filtros, la lógica de fecha y la lógica de agregación antes de aprobar la llamada a la herramienta.

Contenido relacionado

• Servidores MCP en Visual Studio Code