用途:面向 Microsoft Fabric Data Warehouse 提供性能分析、深度诊断与优化建议,通过 fabric-sqlendpoint-execute_query MCP 工具和内置 queryinsights 视图执行监控 T-SQL,全部为只读查询,可用于定位慢查询、SQL 池压力、缓存冷热与聚类键建议,并明确约束不得推荐 Fabric 不支持的优化特性。
主要能力:性能分析(长耗时查询汇总、CPU/存储消耗大户、用户洞察、近期与基线对比、近期查询、按表/列/关键词搜索历史查询模式);深度诊断(分析长耗时查询计划、压力窗口分析、查询缓存冷热分析、聚类键推荐)。
使用方式:需先用 az rest 与 JMESPath 发现 workspaceId 与 warehouse itemId,再调用 MCP 工具,签名为 fabric-sqlendpoint-execute_query(workspaceId, itemId, query),query 为不含 GO 分隔符的单批次 T-SQL,返回 RFC 4180 CSV 结果与元数据文本。需具备目标工作区的 Admin 或 Member 角色,仓库需有近期查询活动(queryinsights 保留 30 天,数据延迟最多 15 分钟)。全局 MCP URL 为 https://api.fabric.microsoft.com/v1/mcp/dataPlane/sqlEndpoint;调用 api.fabric.microsoft.com 时须携带请求头 x-ms-fabric-skill: sqldw-operations-cli(az rest 用 --headers "x-ms-fabric-skill=sqldw-operations-cli"),包括每次 LRO 轮询与重试。会话中首次使用需先运行 check-updates 技能,同一会话已检查可跳过。
限制:MCP 工具限制为最多 10000 行、300 秒超时、每分钟 20 次请求(为观察到的默认值,服务可变更,需按实际 429/超时/截断响应核实)。Fabric DW 不支持非聚集索引、物化视图、索引提示、多列统计、ALTER TABLE SET DATA_CLUSTERING_KEY、RENAME OBJECT、修改隔离级别、CREATE USER、触发器和递归 CTE;聚类须用 CTAS 配合 WITH (CLUSTER BY (...)) 与 sp_rename 交换表。queryinsights 仅适用于 Warehouse,不适用于 SQLEP。安装、定价等细节暂未提供。